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PREFACE 


This publication is organized in three 
chapters. Chapter 1 is an introduction 
describing the relationship between the 
compiler and the operating system, and the 
overall organization of the compiler. 
Chapter 2 is a general description of each 
logical phase followed by descriptions of 
each of the physical phases contained in 
the logical phase* Chapter 3 consists of 
flowcharts, tables and routine directories. 
The flowcharts show the relationship 
between the routines of each phase, while 
the tables and directories list the 
routines and their functions. 

The appendixes contain topics of special 
importance and reference material. 

The convention has been followed in this 
manual of printing all PL/X language items 
in block capitals. 

Prerequisite to the use of this 
publication are the following: 

IBM Svstem/360 : 

Principles of Operation . Order No. 

GA22-6821 

IBM Svstem/360 Operating System s 

PL/I(F) Language Reference Manual . Order 

No. GC28-8201 

PL/ 1(F) Programmers Guide . Order No . 

GC28-6594 


Although not prerequisite, the following 
publications are related to this manual and 
should be consulted: 


IBM Svstem/360 Operating System : 


Operator’s Reference. Order No. 
GC28-6691 


Operator* s Procedures . Order No. 
GC28-6692 


System Programmer^ Guide . Order No. 
GC28-6550 

Storage Estimates , order No. GC28-6551 

System Generation . Order No. GC28-6554 

Supervisor and Data Management Services . 
Order No. GC 28- 664 6 

Supervisor and Data Management Macro 
Instructions Order No. GC 28-6 647 

Sequential Access Methods. Program Logic 
Manual , order No. GY28-6604 

Introduction to Control Program Logic. 
Program Logic Manual . Order No. 

GY28-6605 

PL/I Subroutine Library. Program Logic 
Manual. Order No. GY28-6801 
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CHAPTER 1: INTRODUCTION 


PURPOSE OF THE COMPILER 


The IBM System/360 Operating System PL/ 1 
(F) Compiler analyzes and processes source 
programs written in PL/I, and translates 

I them into a form suitable for input to the 
Linkage Editor or Linkage Loader. When 
errors are detected in the source program, 
appropriate diagnostic messages are 
produced. The compiler functions within 
IBM System/360 Operating System and may be 
used on machines where at least 45,056 
C44K) bytes of main storage are available 
for the compilation (exclusive of storage 
requirements for the operating system) . 


THE COMPILER £ND THE OPERATING SYSTEM 


The PL/I (F) Compiler is a processing 
program of IBM System/360 Operating System. 
The compiler consists of a number of phases 
under the supervision of compiler control 
routines. The compiler communicates with 
the control program of the operating 
system, for input/output and other 
services, through the control routines. 

A compilation is introduced as a job 
step under the control of the operating 
system, via the JOB statement, the execute 
(EXEC) statement, and the data definition 
(DD) statements of the Job Control 
Language, for the input /output data sets. 
Cataloged procedures are provided to keep 
these statements to a minimum. A 
discussion of the introduction of a 
compilation as a job step, and of the 
available cataloged procedures, is given in 
the publication IBM System/360 Operating 
System, PL/I (F) Programmer* s Guide . 

The source proqram to be compiled 
appears as input to the compiler on the 
SYS IN data set. The compiler uses SYSUT1 
(required if the main storage is 
insufficient to contain the program) and 
SYSUT3 (required if the 48-character set or 
the compile-time processor is used) as work 
data sets. The SYSPRINT data set is 
mandatory. The SYSPUNCH and SYSLIN data 
sets are used, depending on the options 
specified by the source programmer, to 
contain the output from the compiler. 

The overall data flow associated with a 
compilation, and the data sets used in the 
compilation, are illustrated in Figure 1. 


A compilation is initiated by loading 
the compiler control routines from the Link 
Library. The compiler control routines 
then carry out their own initialization, 
including loading those compiler control 
routines which remain in storage throughout 
the compilation. These routines perform 
the following functions: 

1. Act as the interface between the 
compiler phase and the operating 
system, controlling all input/output, 
storage allocation, program 
interruptions, storage dumping, etc. 

2. Supervise the loading of compiler 
phases in accordance with source 
program options and information 
obtained from the source program by 
the compiler phases. 

3. Supervise all workspace used by the 
compiler for information concerning 
the source program. This includes any 
spilling from main storage to 
auxiliary storage in order to 
accommodate large source programs, the 
conversion of symbolic references to 
absolute addresses, and the conversion 
from absolute addresses to symbolic 
references. 

4. Provide a number of routines to assist 
in compiler debugging. 

The compiler options specified are 
interpreted and the appropriate action 
taken. The environmental options, such as 
storage size and device type, are used to 
calculate the text and dictionary block 
size and the "spill" point (i.e. the point 
at which the main storage available is 
insufficient to contain the dictionary and 
text) . 

To determine the block size a table 
contained in Phase AB is used. The storage 
size is used as the argument to search the 
table. When the correct entry is found, 
the text block size and the dictionary 
block size values are extracted and used 
for the compilation. 

The options are instructions to the 
compiler. Some of these require a phase to 
be loaded that would not otherwise be 
loaded. When an option of this type is 
found, a request for the phase required is 
inserted into the status byte in the phase 
directory. Other options are in the form 
of instructions to a phase that is always 
loaded. These instructions are also placed 
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in coded form in the communications region 
of the dictionary, generally in the Control 
Code word (see CCCODE in Appendix B) . 


COMPILER ORGANIZATION 


The PL/I (F) Compiler comprises a number of 
logical phases, each of which consists of 
several physical phases as shown in 
Appendix A. 

The compiler phases and their 
corresponding functions are indicated in 
Figure 2, and the organization of the 
compiler is shown in Figure 3. 

Control is passed between the phases of 
the compiler via the control routines. 

After each phase has been executed, it 
branches to the control routine, which 
selects from its load list the next phase 
to be executed. 

Communication between the phases is 
implemented by the following: 

1. The text string. The text string at 
the start of the compilation is input 
text. This is converted by the 
compile-time processor, if necessary, 
into a string which is PL/I source 
text. The characters in this string 
are translated into a code internal to 
the compiler. The phases of the 
compiler gradually process the text 
until the final foruv is the object 


program, consisting of a string of 
machine instructions. For the 
compiler proper, the text code bytes 
used, and formats of statements at 
different stages of the compilation, 
will be found in Appendix D. 


The text is broken down into a number 
of blocks, depending upon the size of 
the machine. Each block has a 
symbolic name which is independent of 
the physical location of the block in 
storage. Thus, the text blocks may be 
moved around in main storage under the 
supervision of the compiler control 
routines, and spilled on to auxiliary 
storage if insufficient main storage 
is available. 

2. The dictionary. The dictionary 

consists of a number of blocks, each 
with a symbolic name. Part of the 
first dictionary block is used as a 
communications region (see Appendix F) 
between phases, and for this reason 
the first block is never spilled, even 
when the source program to be compiled 
exceeds available storage. The 
communications region contains such 
information as the addresses of the 
heads of chains, the symbolic start of 
text, etc. The remainder of the 
dictionary contains all information 
relating to identifiers appearing in 
the program, temporary storage areas 
required, etc. For the compiler 
proper, the format of all dictionary 
entries will be found in Appendix c. 
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j Logical Phase 
j Corr.pile-time Processor 


Function 


Reads input text, executes any compile- time statements j 

contained in it, and modifies text as directed, producing j 
modified text for further compiler processing. 

I 

Checks source program syntax and removes all superfluous | 
characters, such as comments and non-significant blanks, ] 
from the text string. | 

Removes all BCD identifiers and attribute declarations from| 
the source string, and replaces them by symbolic references! 
to dictionary entries. The dictionary entries contain all 
the consistent declared attributes, and all the attributes ! 
specified in the language in default of source program 
specifications. Error messages are generated for all 
inconsistent attributes. I 

Processes those features of the language that are more 
easily processed in their original PL/I form, than when thei 
original syntactic form has been lost in later phases. The] 
Pretranslator carries out these modifications which include 
the rearranging of the order of certain I/O statements, the I 
creation of temporary variables for procedure arguments 
which are expressions, the conversion of array and 
structure assignments to a series of DO-loops surrounding 
scalar assignments, and the removal of iSUB expressions. 

Converts the original PL/I syntactic form to an internal 
syntactic form, referred to as "triples." Triples consist 
of the original source program operators and operands, but 
rearranged so that the operations specified in the source 
string may be carried out in their proper order. 

Carries out all structure and array mapping, so that 
elements are aligned on the correct storage boundaries. 

When it is not possible to carry out the mapping at 
compilation time, such as when the aggregates contain 
string lengths or array bounds which are specified by 
expressions, object code is produced to do it at object 
time. This phase also checks that items' DEFINED on arrays 
and structures can be mapped consistently. 

If optimization is requested, the optimization phases 
attempt to reorder triples for subscript address 
calculations and generate efficient pseudo-code for DO-loop 
control. This enables some PL/I programs to compile into 
faster object code at the cost of extra compile time. 

Converts the triples to a form closely resembling machine 
instructions, in which registers are represented 
symbolically, and storage locations are represented by 
dictionary references with offsets. The final pseudo-code 
version of the text also contains a number of special 
pseudo-code items for the guidance of later phases. 



•Figure 2. Compiler Logical phases (Part 1 of 2) 
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Description 


j Logical Phase 

»• 

J Storage Allocation 


j Storage Allocation j Searches the dictionary for all entries requiring storage, j 
j j and allocates offsets to each item, either within its j 
j | AUTOMATIC block, or within the STATIC storage area. Code | 
j | is compiled to set up dope vectors and pointers at object | 
j j time, for allocations of controlled variables and j 
j j temporaries, the storage for which must be obtained during j 
j j the execution of the object program. Prologue code is | 
j j generated for each block of the object program. j 

I I I 

| Register Allocation | Allocates physical registers to the symbolic registers | 
j j which have been requested by earlier phases, and also | 
j j ensures that all the storage location offsets allocated in j 
j j previous phases can be addressed by the insertion of j 
j | additional instructions, where necessary. | 

I I I 

(Final Assembly | Completes the translation to machine code instructions, by | 
j j calculating branch destination addresses inserted | 
j j symbolically by earlier phases. Loader text is then j 
j j produced for the machine instructions, constants, INITIAL j 
j j values in STATIC storage, and all the constant data | 
| j required for block initialization. ESD and RLD cards are | 
| j produced to enable the object program to be edited by the | 
j j Operating System/360 Linkage Editor or the Linkage Loader, j 
j J The Final Assembly Phase also produces a listing of the | 
j j object code produced. | 

I I I 

(Error Editor ( Entered at the end of every compilation. The dictionary isj 
j j examined to determine whether there are any diagnostic j 
J j messages to be printed out. If there are none, the | 
| | compilation is terminated by the compiler control. If j 
j | there are diagnostic messages to be printed out, the error j 
j ( dictionary entries are processed and the messages are j 
J j printed. The texts of all the diagnostic messages are heldj 
j j in modules XG through YY. | 

Fiqure 2. Compiler Logical Phases (Part 2 of 2) 
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CHAPTER 2: THE COMPILER LOGICAL PHASES 


Note: For descriptions of terms and 
abbreviations used in the text during a 
compilation which are mentioned in this 
chapter, refer to Appendix D.ll. 


COMPILER CONTROL AND 48-CHARACTER SET 
PREPROCESSOR 


COMPILER CONTROL 


When the PL/I (F) Compiler is invoked by 
the calling program (e.g., the Job 
Scheduler) of the operating system, the 
Compiler Control module IEMAA is loaded and 
entered. IEMAA is resident during the 
whole compilation; it controls the 
following functions: 

Initial iz at ion 

Character translation 

Communication between phases 

Text and dictionary block control 

Scratch storage control 

Storage requirements 

Phase loading 

Phase directory construction 
Diagnostic message control 
Input/output control 
Program check handling 
| Compile-step termination 


Initialization 


Initialization is achieved by module AA 
linking to module AB. Module AB performs 
the detailed initialization of the 
compiler, and provides the following 
functions : 

Opens SYSIN and SYSPRINT data sets 

Constructs a phase directory (for details 
refer to Appendix B) 

sets up a communications region in the 
dictionary (for details refer to Appendix 
F) 


Scans option list 

Obtains space for text blocks and 
dictionary blocks. 

Opens SYSUT3 and SYSPUNCH as necessary 

Prints a list of options used in current 
compilation 

Loads phase AN to handle a normal 
dictionary, or phase AL if an extended 
dictionary is requested. 

On return from module AB, the first 
compiler phase is loaded and entered. 


Character Translation 


The character translation tables (see 
Appendix D.l) provide the facility for 
converting external code to a compiler 
internal code, and for converting the 
internal code back to the external form. 
These tables thus prevent the compiler from 
becoming character code dependent, and 
enable the scanning routines to process the 
input source statements more efficiently. 
Note that the contents of these tables are 
different during compile-time processing 
from the contents during compilation 
proper. 


Communication Between Phases 


The communications region is an area 
specified by the control routines, and used 
to communicate necessary information 
between the various phases of the compiler. 
The communications region is resident in 
the first dictionary block throughout the 
compilation. 

Entry to the various compiler control 
routines is via a transfer vector. Details 
of the transfer vector and the organization 
of the communi cations region appear in 
Appendix F. (Note: The use of the 
communications region during compile-time 
processing is described in Appendix J.) 


Text and Dictionary Block Control 


Block control is achieved by a system of 
text and dictionary references. If the 
program in storage becomes too large. 
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blocks are placed on an external file, 
SYSUT1. The block control routines contain 
the input/output control. 


Block Control Area 


The block control area contains two tables,, 
DSLOTS and TSLOTS, and is held in modules 
AL/AN. The DSLOTS table contains 70 4 -byte 
slots, and the TSLOTS table contains 96 
4-byte slots. The first six slots in each 
table are used by the compiler control 
routines for holding general block 
information. The remaining slots contain 
details of the status and position of text 
and dictionary blocks, one slot per block. 


The format of each slot is as follows: 
1 byte indicator 


3 byte address - (a) if the block is in 

main storage it 
contains the absolute 
address of the start 
of the block. 


(b) if the block is on 
disk it contains the 
relative track 
address of the block 
in the spill file. 


The format of the indicator byte is X 
'ab* where: 

ab = FF if the block has not been 
allocated 

a = 8 if the block is in storage 

a = 0 if the block is on the spill 

file 

b = 4 if the block is busy (i.e., 
locked into storage) 

b - 3 if the block is wanted (i.e., 

spillable but preferably kept in 
storage) . 

b = 2 if the block is not wanted 
(i.e., information to be 
retained but block may be 
spilt) . 

b = 1 if the block is free (i.e., 

information no longer required) . 


Text Block Chaining 


When text blocks are chained, the second 
byte of the last but one word of each block 
contains the block number of the next block 
in the chain. 


Scratch storage Control 


Scratch storage of 4K bytes is guaranteed 
to all phases. The control routines split 
the 4K-block into discrete sections, each 
of 512 bytes , and allocates them as 
required. 


Storage Requirements 


The PL/ I (F) Compiler requires main storage 
for the following purposes : 

Compiler processing phases 

Print buffers 

Compiler control routines 

Dictionary area 

Text area 

Input/Output buffers 
Input/Output routines (QSAM) 

The main storage required by each phase 
of the compiler need be contiguous only for 
each control section. 

During the read- in logical phase a 
minimum of two dictionary blocks and two 
text blocks is available in storage 
simultaneously. During the optimization 
logical phase, a minimum of three 
dictionary and five text blocks is 
available in storage simultaneously. 

During the rest of the compilation four 
dictionary blocks and four text blocks are 
available in storage simultaneously. 

The dictionary and text block size is 
chosen according to the amount of main 
storage available to the compiler. The 
SIZE option, interpreted at invocation 
time, provides the value used to determine 
the block size. A table contained in Phase 
AB is searched, using the SIZE option as an 
argument. When the correct entry is found, 
the block size is extracted. 
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I Compile- step Termination 


Appendix E shows details of storage 
allocation. 


Phase Loading 


Phase loading routines include phase 
marking (where phases are indicated as 
wanted or not wanted) , phase loading, and 
phase deleting facilities. The phase 
directory is constructed for this purpose. 


Phase Directory Construction 


Because of the number of phases in the 
compiler, the phase directory is split into 
halves. The first half is constructed 
during the initialization of the compiler; 
also a list of names of the phases in the 
second half is kept in Phase AA. This list 
is used to pass status indications (i.e., 
whether phases are wanted or not wanted) 
from the first half to the second half. 
Phase JZ uses the list to construct a new 
directory for the second half. (The error 
message phases have their own phase 
directory, which is built in phase XB and 
uses the same space in AA as the phase 
directory proper.) 

The phase directories are constructed by 
use of the BLDL macro and a build list. 

The format of the build list is fully 
described in the publication IBM System/360 
Operating System, supervisor and Data 
Management Services . For details of the 
phase directory see Appendix B. 


Diagnostic Message Control 

Diagnostic message control routines cause 
diagnostic messages to be placed in a chain 
in the dictionary. 


Input/Output control 


The I/O control routines involved act as an 
interface between the compiler phases, and 
SYSIN, SYSPRINT, SYSLIN, and SYSPUNCH data 
sets. (See Figure 4.) 


Program Check Handling 


The compiler handles all program checks. 
Control can be passed to a phase to enable 
it to deal with the check. 


The compiler completion code is picked up 
and control is returned to the calling 
program. 


The compiler completion codes are as 
follows : 


Code Meaning 

0 No diagnostic messages issued; 

compilation comple ted with no 
errors; successful execution 
expected 

4 Warning messages only issued; 

program compiled; successful 
execution is probable 

8 Error messages issued; compilation 

completed, but with errors; 
execution may fail 

12 Severe error messages issued; 

compilation may be completed but 
with errors, successful execution 
improbable. If a severe error 
occurs during compile-time 
processing, the compilation will be 
terminated and., if the SOURCE 
option has been specified, a 
listing of the PL/I program text 
produced by the compile-time 
processor will be printed. 

16 Termination error messages issued; 

compilation terminated abnormally; 
successful execution impossible. 


COMPILER CONTROL MODULES 


In addition to modules AA and AB, further 
modules, AC, AD, AE„ AF, AG, AH, AI, AK, 
AL, AM, AN, and JZ are used in compiler 
control. The functions of these modules 
are briefly described in the following 
paragraphs . 


Module AC 


Module AC controls reading and writing 
operations on SYSUT3, the intermediate 
file. It is loaded only if the CHAR48 or 
MACRO option is specified, and is deleted 
at the end of the Read-In Phase. 
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Module AD 


Module AD performs inter-phase dumping. 

All specified active storage is dumped 
at the end of the phases stated or implied 
in the DUMP option. If the DUMP option 
includes either I, for the Annotated 
Dictionary Dump, or E, for the Annotated 
Text Dump, or both, then phase AD will load 
either phase AH, or phases AI and AJ, or 
all three, to produce the required output. 


The DUMP Option 


The DUMP option which is specified in the 
PARM field of the EXEC card indicates where 
dumping of main storage is to take place. 

It may be specified in one of the following 
ways: 

1. DUMP, means a dynamic dump is required 
(the dump routine will be called by a 
running phase) 

2. DUMP=(area, x a .,x a ,x 3 , . .. .x n ) means a 
dump of the storage after the named 
phase where x is the name of a phase. 

Area is any combination of TDPSCIE: 

T text blocks 
D dictionary blocks 
P phases loaded 
S scratch storage 
c control phase 
I annotated dictionary blocks 
E annotated text blocks 

The general syntax is: 

DUMP t=( (area) , (x| (y,z) >,...) 1 where x, 
y and z are phase names. 

A single phase name indicates dumping of 
storage after this single phase. A pair of 
phase names indicates a continuous group of 
phases after which dumping of storage is to 
occur. 

The dump will appear on SYSPRINT, 
inserted into the normal compiler output. 

If area is omitted the default taken is 
DTSP. If a program check occurs and DUMP 
has been specified then area will be given 
the default DTSPC. 

If the area specifies both T and E or 
both D and I, only the r el event edited dump 
will be printed. 

If the area contains P, a message is 
printed on completion of every phase, 
whether mentioned in the DUMP parameter or 
not. 


Use of the DUMP option may cause the 
compiler to use about 8K bytes more main 
storage than the SIZE option specifies. 
This is because SIZE specifies the amount 
of main storage the compiler can use for 
normal compilation and does not allow for 
the internal compiler diagnostic dumps. 


Example of an EXEC card using the DUMP 
option: 


//STEP1 EXEC PROC— PL1LFC , 

PARM. PL1L='DUMP= (TIP, OE,QU) ' 


This statement specifies compilation using 
the DUMP option to obtain a printout of the 
text blocks, the annotated dictionary, and 
the loaded phases after the completion of 
compiler phases OE and QU. 


Module AE 


Module AE is the finalization of the 
Read-In Phase control. (See Fig. 4, Note 1 ) 


Module AF 


Module AF is a control section consisting 
of a table containing the compiler options 
which may be used during a compilation. 

The table is constructed at system 
generation time. The control section is 
brought into storage by the initialization 
Module AB at compilation time. A 
description of the use of Module AF is 
given in Appendix G. 


Module AG 


Module AG closes SYSUT3 for output, and 
re-opens it for input. 

The closing and opening operations are 
performed in the following order: 

CLOSE 

alter macro- type in data control block 
(DCB) 

OPEN (INPUT) 

switch routine ZURD to point at the 
SYSUT3 data control block 
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Module AH 


Module AM 


Module AH produces a dump of the 
dictionary. It prints out the 
communications region in the first block, 
and the offsets tables for each block if 
the extended dictionary option is in use. 
The remainder of each block is printed out 
entry by entry. The BCD is translated for 
those entries containing BCD. At the end 
of the dump, a list of all the dictionary 
codes used is given, with an explanation 
for each code. 


The module is called by phase AD only if 
an I is specified in the area field of the 
DUMP option. 


Modules AI and AJ 


Modules AI and AJ are called, if E is 
specified in the area field of the dump 
option, to provide an 'easy-to-read* text 
print in which the triples and pseudo-code 
items comprising the text are printed 
separately. This option is available 
between phases I A and OE inclusive. 


Module AK 


Module AR is the closing routine of the 
compiler. Its function is to release main 
storage used for dictionary, text blocks, 
scratch storage, and completed phases. If 
batch compilation is not specified, module 
AK closes all the files used by the 
compiler. If a batch compilation is 
specified, a check is made to determine 
whether any source programs are still to be 
compiled. Where there are none module AK 
closes all files. Where one or more 
programs remain to be compiled, the spill 
file only is closed, the batch delimiter 
card is scanned for syntax errors, and 
control is returned to module AA. 


Module AL 


Module AL contains the control routines for 
dictionary and text-block handling for the 
extended dictionary. 


Module AM marks phases as either wanted or 
not wanted, depending upon the compiler 
invocation options. Phases that are always 
loaded are marked wanted. 

AM is the first compiler phase loaded 
after compiler initialization. It tests 
the relevant bits in the Control Code word 
(CCCODE) and marks the phases accordingly. 


Module AN 


Module AN contains the routines for 
dictionary and text-block handling for the 
normal- sized dictionary. 


Module AT 


Module AT provides extra debugging features 
during compiler runs. The three features 
of this module are: 

1. A 'TRACE* of all instructions executed 
between specified locations within 
specified compiler modules. 

2. A 'FLOW* of branches taken between 
specified locations within specified 
compiler modules. 

3. The ability to VERIFY and REP (replace) 
patches within specified compiler 
modules. 

Note : Features 1 and 2 can be inhibited 
until a particular statement is 
reached. 


The TRACE/ PATCH Option 


The following must be done to use the 
facilities described above in Module AT: 

1. *T* (Trace or Flow) or 'P' (Verify or 
Rep) must be inserted in the compiler 
option list. 

2. A size of at least 12K less than the 
size available must be specified. Do 
not attempt to use SIZE=999999. 

3. As the output will go to a dataset 
named TRACEOUT, the following DD card 
will also be required in the JCL for 
the compile step: 
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//TRACEOUT DD SYSOUT=A 


In addition, control cards will be 
required which must be inserted before the 
first card of the source program. Up to 10 
each of TRACE/FLOW and VERIFY/REP cards are 
permitted . 

To obtain TRACE/FLOW facilities the 
control card should contain the following 
informations 

* in card column 1 


Keyword "TRACE* or "FLOW" 

Two- letter module name 

Four-digit hexadecimal 
offset of instruction 

Two-letter module name' 

of end of 

Four-digit hexadecimal ’ Trace or Flow 
offset of instruction 


I of start of 

I Trace or Flow 


tSTAT=nnnnn] where nnnnn is 

five-digit decimal PL/ I 
statement number at 
which Trace/Flow is to 
start. 

Note ; This field is 
optional and may be 
used only if the module 
in which TRACE/FLOW is 
to start updates Z ST AT . 

Example: 

* TRACE GB 012B GU 036C 


Note : Fields should be separated by at 
least one blank, and end in or 
before column 72. 


To obtain the PATCH facilities the 
control card should contain the following 
information: 


* in card column 1 


Keyword "VERIFY" or "REP* 


Verify operation, an error message will be 
given on the data set TRACEOUT. Note that 
Rep operations do not depend on a previous 
valid verify operation. 


Module F I 


Module FI checks whether Syntax Check 
should terminate compilation. The three 
options for the Syntax Check are recognized 
in module AB and flags are set. On 
completion of the Read-in and Dictionary 
phases, these flags are tested by module 
FI, which was loaded when phase FX released 
control. The decision to terminate or 
continue is made based on the flag settings 
and the level of error severity encountered 
(by inspecting the heads of the error 
chains) , and a special message is issued at 
this point. 


Module J Z 


Module JZ builds the second half phase 
directory. A build list is constructed 
from the second half list held in Module 
AA? a BLDL is performed on this list. The 
phase directory is then reconstructed in 
Module AA for the second half of the 
compiler. 


48-CHARACTER SET PREPROCESSOR 

Phase BX is the 48-character set 
preprocessor. It is loaded on programmer 
option and receives, as input, source text 
in the 4 8- character syntax. 

The preprocessor scans the input text 
for occurrences of characters peculiar to 
the 48-character set, and converts these to 
the corresponding 60-character symbols. It 
then puts out the adjusted text onto 
auxiliary storage ready for Phase Cl, the 
first pass of the Read-In Phase. 


Two- letter module name 

> of Patch 

Four-digit hexadecimal * location 
offset 

Note : Hexadecimal Patch data may be 

separated by commas if desired. 

Example: 

* VERIFY GB 032A 

VERIFY and REP instructions are carried 
out as soon as the module concerned is 
loaded. If the data does not compare on 


The text is read in record by record. 

It is then scanned for alphabetic 
characters which may be the initial letters 
of operator keywords, for periods, and for 
commas. Items within comments or character 
strings are ignored. 

When a possible initial letter is 
discovered, tests are made to determine 
whether or not one of the reserved operator 
keywords has been found. If one has been 
found, it is replaced by its 60-character 
set equivalent. Similarly, appearances of 
two periods are replaced by a colon, and a 
comma-period pair is replaced by a 
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semi-colon if the comma-period pair is not 
immediately followed by a numeric 
character . 

Allowance is made for the possibility 
that a concatenation of characters which is 
meaningful in the 48-character set may be 
split between two records. 

Before the text is processed a copy of 
the original input is preserved. The 
output from the preprocessor is the 
transformed text, record by record, 
followed by the original text. The Read-In 
Phase processes transformed text but prints 
out the original. 

The 48-character set preprocessor uses 
Compiler Control routine ZURD to obtain 
input, and routine ZUBW to place its output 
onto auxiliary storage. 

Note : If the MACRO option is specified, all 
the processing described above is 
done by the compile- time processor, 
and phase BX is bypassed. 


COMPILE-TIME PROCESSOR LOGICAL PHASE 


The compile-time processor consists of six 
physical phases. Each of these phases is 
executed once, unless an INCLUDE data set 
is encountered. In this case certain 
phases will be re-executed. 

The compile-time processor moves source 
text that does not contain compile-time 
statements directly into text blocks. 

During this process invalid characters are 
replaced by blanks, and line numbers are 
encoded and inserted into the text. 
Compile-time statements are decoded and 
translated into an internal form and then 
placed directly into text blocks. An entry 
is made into the dictionary for each 
compile-time variable, procedure, label, or 
INCLUDE identifier. 

A second pass is then taken over these 
text blocks, during which compile- time 
statements are executed and the PL/I source 
program text is scanned and replacements 
are made. The output from this pass is a 
PL/I source program contained on SYSUT3 
and, optionally, a punched card deck. 

If during the second pass, an INCLUDE 
data set is processed, the entire procedure 
indicated above is executed recursively to 
process this text. 

Text and dictionary formats used by the 
compile-time processor are contained in 
Appendix J. 


Line Numbering 


As the input is being processed a unique 
line number is assigned to every logical 
record processed. If a listing of the 
input is requested, these line numbers are 
written out beside the appropriate line. 
The line numbers are also encoded and 
inserted into the text so that diagnostics 
can be keyed to them. These line numbers 
are also output on SYSUT3 , to aid the user 
in determining from which input line a 
particular line of output came. 


Phase AS 


This phase, consisting of one physical 
module, is loaded if the MACRO option is 
specified. It is resident throughout 
compile-time processing until the cleanup 
phase (BW) is invoked. 

This phase controls the loading of the 
subsequent compile- time processor phases. 
The initialization phase (AV) is loaded 
only once. The two processing phases (BC 
and BG) are loaded and executed once unless 
an INCLUDE data set is processed. In this 
case phase AS reloads the processing phases 
to process this data set. 

In addition, phase AS contains a set of 
service routines used by both processing 
phases. Access to these routines is via a 
transfer vector located at the beginning of 
phase AS. 


Phase AV 


This phase consists of one physical module. 
Its purpose is to initialize certain cells 
in the communications region for the 
compile-time processor phases. 


Phase BC (BE, BF) 


Phase BC consists of three physical 
modules, BC, BE, and BF. Module BE 
contains the control routine. 

Phase BC accepts input text, moving it 
into text blocks until a compile-time 
statement is found. (For a description of 
the use and layout of text and dictionary 
blocks, see Appendix J.) When a 
compile-time statement is encountered, it 
is encoded into a set of interpretive 
instructions and, except for compile-time 


Chapter 2: The Compiler Logical Phases 27 



procedures, added to the current text 
block. Compile- time procedures are 
similarly encoded, but are placed in 
separate text blocks. 

As compile-time statements are encoded, 
all non-keyword identifiers encountered are 
entered into the dictionary, together with 
any attributes that are known. Entries are 
also made in the dictionary for constants 
and iterative DO-loops. 

During phase BC, invalid characters 
occurring outside of strings and comments 
cause a diagnostic to be printed. They are 
converted to blanks. Invalid characters 
can thus be used for markers of various 
sorts in text blocks. Diagnostics are 
given for syntax errors in compile-time 
statements. Line numbers are encoded and 
inserted into the text for the use of the 
phase BG scan. All input characters are 
converted to their EBCDIC representation 
before they are processed. 


The output of this phase is a PL/l 
source program contained on SYSUT3, and, 
optionally, as a sequenced card deck. 


Phase BM (BO) 


Phase BM examines the heads of the error 
chains in the first dictionary block, and 
programmer options which specify the 
severity level of messages required. If 
there are no messages, it passes control to 
the clean-up phase (BW). if diagnostic 
messages are required, the phase loads BN 
to processv them after scanning the chains 
and indicating where the text is to be 
found, from the message directory block, 
module BO.. 


Module BN (BP, BV) 


Phase BG (BI, BJ) 


Phase BG consists of three physical 
modules: BG, BI, and BJ, which contain the 
control routine, the macro-code 
interpreter, and the built-in function 
handler, respectively. 

In general, the input to phase BG is the 
set of chained text blocks and dictionary 
blocks created by phase BC. The phase BG 
execution is essentially that of the 
compile-time processor described in the 
external specifications. That is, its 
basic action is to move through text blocks 
looking for instances of compile-time 
variables or compile-time statements, which 
it uses to produce the output text. As 
line numbers are encountered in the text, 
they are placed into a location containing 
the current line number. This is used both 
for phase BG diagnostics and by the output 
editor. 

If a compile-time variable or procedure 
reference is found, the scan cursor is 
positioned to scan its value. When the 
scan of the value is completed, the cursor 
is properly positioned back into the text. 
If a compile-time variable or procedure 
reference is found in this value scan, the 
process repeats itself. Such nesting can 
occur to a depth of 100 . 

If the scan encounters an encoded 
compile-time statement (built by phase BC) , 
control is passed to an interpreter. This 
interpreter executes the statement : — 
possibly repositioning the scan cursor — 
and returns to the scan. 


The text of all compile-time processor 
error messages is kept in modules BP 
through BV. The messages are ordered by 
severity, within these modules. BM will 
have listed those modules which contain 
messages required for a particular pass. 
Module BN loads and releases these modules, 
one at a time and extracts the required 
messages. When all compile-time error 
messages have been processed, module BN 
returns control to BM. 


Phase BW 


The purpose of this phase to set all tables 
and communication region cells to the 
values required by the compiler proper. In 
addition it will release all text and 
dictionary blocks used by the compile-time 
processor phases and then pass control to 
the next required phase of the compiler. 

If a severe or terminal diagnostic has 
been produced by the Compile- time processor 
a listing of the contents of SYSUT3 will be 
printed (provided that the SOURCE option 
applies), and compilation will be bypassed. 


THE READ-IN LOGICAL PHASE 


The Read- In Logical Phase consists of five 
discrete physical phases, each of which 
processes a particular group of statement 
types. The phase obtains the input text in 
the externally coded form Ipy a cill to the 
compiler read routine, and converts it to 
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internal code by means of a translation 
table provided by compiler control. 


The source text is scanned for 
syntactical errors. During this time an 
output string is built up, which consists 
essentially of the input text with comments 
and insignificant blanks removed. The 
source text is scanned and statements are 
numbered, identified, and diagnosed. Any 
required substitutions are made, statement 
labels are inserted in the dictionary, and 
chains are formed (for example, BEGIN, 
PROCEDURE chains). If the SOURCE option 
applies, source statements, with their 
number, and optionally, their block levels 
and DO-nest levels,, are printed out 
immediately after they have been read. 


When the input text provides an 
end-of-file indication, processing is 
terminated. In ERROR situations this may 
not occur when a valid external procedure 
has been completely processed. By keeping 
a count of PROCEDURE, BEGIN, DO, END, ON, 
and IF statements, the phase can detect 
when the logical end-of- program indication 
is found. If there are more records after 
the end of the external procedure, they are 
ignored. 


If an end-of-file indication is 
encountered before the logical end of the 
program, diagnostic messages are issued and 
suitable END statements are inserted to 
allow compilation to continue. 


The output of the Read-In Phase provides 
a syntactically correct output string; a 
table of entry and statement labels; chains 
of coded diagnostic messages; a set of 
switches specifying compilation content 
details; a set of chains linking statements 
of a particular type, to facilitate 
subsequent scanning; and optionally, a 
listing of the source text. 


Statement Numbering 


All statements are given a sequential 
number. This includes each compound 
statement, each statement contained in a 
compound statement, block and group 
delimiting statements, and null statements. 
The numbering of the statement is indicated 
on the source listing. Diagnostic messages 
also refer to these statement numbers. 


Statement and Entry Labels 


Statement and entry labels appearing in the 
source text are removed and added to a 
label table, which is built up in the 
region intended for the dictionary. This 
region may be extended by further blocks as 
required. The label table entry is an 
embryo dictionary entry, with blank regions 
to be filled later by the Dictionary Phase 
EG. 

When a label declaration is found, an 
entry is made in the label table with a 
statement label code, the current (updated) 
sequential number, and the current block 
level and block count. 

Statements having multiple labels give 
rise to multiple label table entries. 

These entries are identical except for the 
BCD name. 

If the statement following a label is 
subsequently identified as a PROCEDURE or 
ENTRY statement, the label table is 
re-accessed, and the entries associated 
with the statement are modified (see 
Appendix C . 2 ) . 


Chains Constructed by Read-In 


To provide rapid scanning in the dictionary 
phases, the following chains are 
constructed by the Read- In Phase: 

The CALL chain 

The PROCEDURE- ENTRY- BEGIN chain 
The DECLARE chain 
The ALLOCATE chain 


Errors and Diagnostic Messages 


As the source text is scanned it is 
syntactically analyzed. Keywords are 
identified and passed as valid only if they 
may legally appear within the type of 
statement being diagnosed. However, 
consistency of attributes and options 
within a statement are not normally 
analyzed. This is left for Phase EK. 

When a syntactical error is detected, an 
attempt is made to correct it and an 
appropriate diagnostic message is 
generated. The main aim of the Read-In 
Phase is to present syntactically correct 
text to subsequent compiler phases. 
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Certain corrections are performed without 
prejudicing the complete compilation. 


Detected errors cause a diagnostic 
message to be added to a diagnostic message 
chain in the dictionary area. Each message 
is in a coded form with parameters (textual 
matter, statement numbers, and so on). The 
message is decoded and printed out by the 
Error Editor. 


Where an error makes it impossible for 
the scan of a statement to continue, the 
statement is terminated correctly at such a 
point as to leave the statement 
syntactically correct. The text between 
that point and the next semi-colon (not in 
a comment or character string) is skipped. 
The diagnostic messages produced in these 
circumstances will include at most the 
first ten characters of the text that is 
skipped. 


The Output String 


The output string is so arranged that a 
complete statement never spans storage 
blocks. One of the conditions of a 
successful compilation is that the output 
resulting from any statement must not 
exceed the block. This restriction, 
however, does not apply to DECLARE 
statements. Formats of the statements 
appearing in the output string are given in 
Appendix D.2. 


Identifiers 


Initial Labels 


Subscripted label variables which are 
initialized by attachment to statements are 
placed in pseudo-assignment statements in 
text, and then handled as if they were 
normal labels. 


STRUCTURE OF THE READ- IN LOGICAL PHASE 


The Read- In Phase can occupy 16K bytes of 
storage for any one pass. A storage map 
for this phase is shown in Figure 5. 

Bytes 
0 

4K 
7K 
8K 
12K 
16K 


Figure 5. Storage Map for the Read-In Phase 

The Read-In Phase consists of five 
phases or passes, each containing at most 
five modules. Modules CA and CC consist of 
common routines which are invoked 
throughout the phase by each of the passes, 
in turn. Modules CE, CK, CN, and CR 
contain separate keyword tables. Details 
of the organization of these tables are 
given in Appendix B. Control for each pass 
resides in modules Cl, CL, CO, CS, and CV 
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PASS 1 PASS 2 PASS 3 PASS 4 PASS 5 


All identifiers which are not recognized as 
keywords in the source text appear in the 
output string. 

Constants 

All constants appear in the output string. 

Operators 

All operators appear in the output string. 


Phase Cl 


During phase Cl (the first physical phase 
of the Read-In Phase) the source text is 
read into storage, and character codes are 
converted to an internal form. Statement 
types are identified, labels are inserted 
into the dictionary, and statement 
identifiers are replaced by single-byte 
codes (see Appendix D.l). 

A record is kept of block nesting levels 
and counts to enable a check to be made for 
the logical end- of- program indication. In 
order to do this, certain statements have 
to be either partially or completely 
analyzed in this pass. 
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These statements are: 

PROCEDURE-END 
BEGIN-END 
DO-END 
IF-THEN- ELSE 
ON 

If the SOURCE option has been requested, 
a listing of the source program, with the 
statements numbered by the compiler, is 
printed out onto the specified output 
medium. 


Phase CL 


The output from phase Cl is processed and 
the statement types listed below are 
analyzed in greater detail: 


ENTRY 

PROCEDURE 

DO 

Iterative DO 
RETURN 
GO TO 
DELAY 
DISPLAY 


FREE 

WAIT 

READ 

WRITE 

DELETE 

UNLOCK 

LOCATE 

REWRITE 


If any errors are detected during this 
pass, diagnostic messages are inserted into 
chains in the dictionary as required. 


Phase CO 


The output from phase CL is processed. In 
particular, the DECLARE, ALLOCATE, and CALL 
statements are analyzed in greater detail. 
The syntax of attributes is checked, but 
their consistency is analyzed during phase 
EK. If the source program does not contain 
any of these three statements, this pass is 
not invoked. 

If any errors are detected during this 
pass, diagnostic messages are inserted into 
chains in the dictionary. 


Phase CS 


The output from phase CL or CO is 
processed. In particular, the syntax of 
input/output statements is analyzed, 
together with the FORMAT statement. If the 
source program contains no input/output 
statements, this pass is not invoked. 


Phase CV 


This phase processes the output from 
earlier phases. In order to assist 
subsequent processing, chains are 
constructed for PROCEDURE, ENTRY, BEGIN, 
CALL, ALLOCATE, and DECLARE statements. 


THE DICTIONARY LOGICAL PHASE 


The Dictionary Phase forms a dictionary of 
identifiers, by first analyzing PROCEDURE, 
BEGIN, DECLARE, and ENTRY statements. The 
text is then scanned for contextual use of 
identifiers, constants, and pictures. 
Finally, every identifier and constant in 
the source text is replaced by a reference 
to its respective dictionary entry. 
Dictionary entries are made during this 
phase for all implicitly defined 
identifiers. The formats of dictionary 
entries appear in Appendix C. 


Constructing and Accessing the Dictionary 


The dictionary, during the construction 
stage, comprises two parts, the hash table 
and the dictionary proper. 

To facilitate a search through the 
dictionary for an entry with a particular 
BCD, a method is used of dividing the 
dictionary into areas. Each area is 
characterized by a property of the BCD of 
each entry in it. In practice, these areas 
are not contiguous but are chained lists, 
each item in the list being one dictionary 
entry long. 

The start of each list is in a table, 
known as the hash table. The association 
of a particular identifier with a list, 
i.e. the characterization of an area, is 
achieved by deriving from a given BCD an 
address in the hash table. 

"Hashing" is a process of reducing the 
length of the internal representation of 
the BCD to one word. This is done by 
adding successive four-byte lengths of the 
BCD into one four-byte register. This is 
then divided by 211, and the remainder is 
doubled to give the hash table address 
associated with the particular BCD. All 
identifiers which hash to the same address 
are placed in a chain; in particular, all 
dictionary entries with the same BCD will 
be in the same hash chain. 

If TOM, DICK, and HARRY occur in the 
same DECLARE statement in that order, and 
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they all hash to the same address in the 
hash table, the address in the hash table 
will point to HARRY'S entry, which contains 
the address of DICK, which, in turn, 
contains the address of TOM. 

When no further BCD entries are to be 
made in the dictionary, and all BCD 
identifiers in the source text have been 
replaced by dictionary references, the hash 
table is deleted. 


Testing for Consistent Attributes 


A test is made at the start of each list of 
attributes, to ensure that any list of 
attributes at one level of factoring in a 
DECLARE statement is consistent. 


Compiler Pseudo- Variables and Functions 


Expressions specified for array bounds, 
string lengths, and initial value iteration 
factors must be evaluated at object time, 
or at allocation time if the variable is 
controlled. The expressions are placed 
temporarily at the end of the text, and are 
later moved by Phase FV and placed 
immediately following the BEGIN, PROCEDURE 
or ALLOCATE statement to which the declared 
variable belongs, ^he expression results 
are assigned to pseudo-variables generated 
by the compiler. These serve two purposes: 
first, the assignment statement appears as 
a normal PL/I statement and need not be 
treated as a special case; secondly, the 
pseudo-variable contains the dictionary 
reference of the variable and information 
concerning the destination of the 
expression. Compiler functions with a 
format similar to the pseudo-variables are 
also created. The function result is the 
specified array bound, or string length. 
Compiler functions are created for two 
purposes: first, to set bounds for base 
elements of structures when the structure 
bound is an expression, or to set the 
bounds of temporary arrays; and secondly, 
to set the storage address of a dynamically 
defined item immediately before its use. 

The formats of all the compiler 
pseudo-variables and functions appear in 
Appendix D.8. 


Dictionary Entries for Entry Points 


A PROCEDURE or ENTRY statement may have 
more than one label. Each label must have 
a data description to indicate the type of 


data returned when the label is invoked as 
a function, and also the type of data to 
which the expression in a RETURN 
(expression) must be converted. These need 
not be the same: there must therefore be 
provision for two data descriptions for 
each label. A PROCEDURE or ENTRY statement 
may specify parameters. The descriptions 
of these identifiers, obtained from DECLARE 
statements or default rules, are used for 
prologue construction, but not for 
parameter matching. Any data description 
given on these statements is to be used for 
conversion at a return (expression), but 
not for determining the result returned by 
a function reference. 


Parameter descriptions for use in 
parameter matching, and data descriptions 
used for determining the type of data 
returned by a function reference, may be 
specified by the source programmer in an 
ENTRY declaration. If these are not given, 
default and implicit rules must be used to 
build a data description, but no parameter 
description can be given. 

Given the foregoing requirements, the 
dictionary entries describing an internal 
entry point are as given in Figure 6. 

The set of dictionary entries A, B, C, 

D, E is repeated for each label associated 
with the PROCEDURE or ENTRY statement. The 
entry F will point to entry A for the first 
label only. D will point at the label with 
which it is associated. It should be noted 
that B and C may coincide. 

The entries type 1 for PROCEDURE, ENTRY, 
and BEGIN statements are chained amongst 
themselves in the following way. Each 
entry type 1 belonging to a PROCEDURE or 
BEGIN statement contains the dictionary 
reference of the entry type 1, of the next 
PROCEDURE or BEGIN statement in the source 
program, and also of the entry type 1 of 
the immediately containing block. 

The entries type 1 of PROCEDURE and 
ENTRY statements belonging to a single 
procedure are chained together in a 
circular manner. If there are no ENTRY 
statements the entry type 1 of the 
PROCEDURE statement points at itself. 

External entry points are described by 
dictionary entries termed entry type 4. 

They contain data descriptions of the value 
returned when referenced as a function, and 
may contain descriptions of parameters. 

Formal parameters which are entry points 
are termed entry type 5, and parameter 
descriptions which are entry points and are 
pointed at by types 3, 4, or 5 are termed 
entry type 6. 


32 



r > I 

r — >j Dictionary entry for entry label 


L_ 


>j Entry type 2. Used to provide 
j data description of target in 
-j RETURN (expression). 

L 


I B 


L_ 

L 

r* 


>1 


Entry type 3. This entry is used | 
to point at the data description C j 
and parameter descriptions for para-|D 
meter matching. j 

"T T 

I I I 




Second entry type 2. 

Used to provide data description 
of value returned when label A 
is invoked as a function. This 
entry may, and usually will, coin- 
cide with B. 


Description of 
first parameter 


j Entry type 1 for 
l- > j PROCEDURE or 
i j entry statement 

L 


| j Description of 


| second parameter 


| j Description of 
| El 


E2 


j each parameter 


IF 


| Formal parameter 
I type 1 entry 


|G 


r : 1 

| Description of para- j 
| meter used in prologue |H 
J construction j 

A 


L j t 

Note: There is an entry E for each parameter described in D. 
Figure 6. Dictionary Entries for an Internal Entry Point 


j 


Phase ED 


Phase ED contains a set of subroutines, for 
processing certain of the tasking and list 
processing attributes, and tables of 
generic and non-qeneric built-in functions. 
Th$? phase obtains IK of scratch storage, 
into which it moves the routines and 
tables, setting a slot in the 
communications region to point at them. 

This address is later picked up and used by 
phase EL. 


I Phase BG(EF) 


Phase EG has two main functions. The first 
is to set up a hash table, and to insert 
the label entries left in the dictionary by 


the Read- In Phase into hash chains. The 
second function of the phase is to create 
dictionary entries for PROCEDURE, BEGIN, 
and ENTRY statements, and to construct 
chains linking entries of particular types. 

For PROCEDURE- BEGIN statements, entry 
type 1 dictionary entries are created (see 
Appendix C.2), and block header chains are 
set up to link these entries sequentially. 

A containing block chain is also set up to 
link each entry with that of its containing 
block. 

BEGIN statements are scanned for the 
ORDER/REORDER option, and the optimization 
byte is created in the entry type 1 (see 
Appendix C.2). 

On the appearance of PROCEDURE 
statements, circular PROCEDURE-ENTRY chains 
are initialized to link the entry type 1 
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dictionary entries of the PROCEDURE and 
ENTRY statements of the same block. The 
formal parameter list is scanned, and 
formal parameter type 1 entries are created 
and inserted into the hash chain. Details 
of the PROCEDURE-ENTRY chains appear in 
Appendix C.2. 

The attribute list and the options are 
scanned and an options code byte and 
optimization byte are created in the entry 
type 1 (see Appendix C.2). A check is then 
made for invalid and inconsistent 
attributes. CHARACTER and BIT attributes 
are processed, and second file statements 
(see Appendix D.8) are created if 
necessary. Precision data are converted to 
binary, and dictionary entries are created 
for pictures (see Appendix C.7). 

statement labels are scanned and their 
entry type 2 dictionary entries are 
created. The relevant data bytes in the 
dictionary are completed by default rules 
(see Appendix C.3). 

For ENTRY statements, entry type 1 
dictionary entries are created (see 
Appendix C.2), and the circular 
PROCEDURE -ENTRY chain is extended. Formal 
parameters, attributes, and labels are 
processed in a similar manner to those for 
PROCEDURE statements, except that the 
options code byte is not created. 


I Phase El (EH, EJ) 


Phase El scans the chain of DECLARE 
statements set up by the Read- In Phase, and 
modifies the statements to assist Phase EK 
as follows : 

Structure Level Numbers: these are 
converted to binary. 

Factored Attributes; parentheses enclosing 
factored attributes are replaced by special 
code bytes, so that Phase EK can 
distinguish them easily. A factored 
attribute table is set up. It consists of 
slots corresponding to each factored level. 
Each slot contains the address of the 
attribute list associated with that level, 
and the address of the slot for the 
containing level. 

The following attributes are processed! 

DIMENSION: dimension table entries (see 

Appendix C.8) are created in the dictionary 
and the source text is replaced by a 
pointer to the entry. Fixed bounds are 
converted to binary and inserted in the 
table. A second file statement (see 
Appendix D.8) is created at the end of the 


text, for adjustable bounds, and a pointer 
to the statement is inserted in the 
dimension table. Identifiers with 
identical array bounds share the same 
dimension table. 


PRECISION: precision and scale constants 

are converted to binary. 


INITIAL: dictionary entries are created 
for INITIAL attributes. 


INITIAL CALL: second file statements are 
created for INITIAL CALL attributes. 

CHARACTER and BIT: fixed length constants 
are converted to binary; a code byte marker 
is left for * lengths (see Appendix C.8). 
Second file statements (see Appendix D.8) 
are created for adjustable length 
constants, and the source text is replaced 
by pointers to the statements. 

DEFINED : second file statements (see 
Appendix D.8) are created and the source 
text is replaced by pointers to the 
statements . 

POSITION : the position constant is 

converted to binary. 

PICTURE : a picture table entry (see 

Appendix C.7) is created and inserted into 
the picture chain; similar pictures share 
the same picture table. The source text is 
replaced by a pointer to each entry. 

USES and SETS: USES and SETS attributes 
are moved into dictionary entries, and 
pointers to the entries replace the source 
text. 

LIKE: BCD entries are created for 
identifiers with the LIKE attribute. 

LABEL: if the LABEL attribute has a list 
of statement label constants attached, a 
single dictionary entry is created. The 
dictionary entry contains the dictionary 
references of the statement label constants 
in the list. 

OFFSET and BASED: Second file statements 
are made and text references are inserted 
in the DECLARE statements for these 
attributes . 

AREA: Fixed-length specifications are 
converted to binary; second file statements 
are made for expressions; a code byte, 
followed by the length of text reference, 
is inserted in the DECLARE statement text. 

All other attributes, identifiers, or 
constants are skipped. 


34 



Phase EL (EK, EM) 


Phase EL, consisting of modules EK, EL, and 
EM, scans the chain of DECLARE statements 
constructed by the Read- In Phase. 

An area of storage known as the 
attribute collection area is reserved. 

This is used to store information about the 
identifiers, and has entries of a similar 
format to that for dictionary entries. 

Complete dictionary entries are 
constructed for every identifier found in a 
DECLARE statement. These identifiers can 
be one of the following types: 

1. Data Items (see Appendix C.4) 

2. Structures (in this case, the 'true' 
level number is calculated) (see 
Appendix C.4) 

3. Label Variables (see Appendix c.4) 

4. Files (see Appendix C.7) 

5. Entry Points (see Appendix C.2) 

b. Parameters (see Appendix C.7) 

7 . Event Variables 

8 . Task Variables . 

Identifiers appearing as multiple 
declarations are rejected and a diagnostic 
message is given. 

The attributes to be associated with 
each identifier are picked up in three 
ways. 

First, the attributes immediately 
following the identifier are stored in the 
attribute collection area. 

Secondly, any factored attributes and 
structure level numbers are examined. 

These are found by using the list of 
addresses placed in scratch storage by 
Phase El. Each applicable attribute is 
marked in the attribute collection area, 
and any other information, e.g. dimension 
table address, or picture table address, is 
moved into a standard location in the 
attribute collection area. All conflicting 
attributes are rejected and diagnostic 
messages are given. 

Finally, any attributes which are 
required by the identifier, and which have 
not been declared, are obtained from the 
default rules. 

After the dictionary entry has been 
made, furtner processing (e.g. linking of 


chains, etc.) must be done in the 
following cases: 

1. DEFINED data 

2. Data with the LIKE attribute 

3. Files 

4. Strings with adjustable lengths 

5. Arrays having adjustable bounds 

6. GENERIC identifiers 

7. Structure members 

8. Identifiers with INITIAL CALL 

9. Identifiers with the INITIAL attribute 

After the declaration list has been 
fully scanned and processed, it is erased. 


Phase EP 


Phase EP first conditionally marks later 
phases as * wanted* or 'not wanted,' 
according to how certain flags in the 
dictionary are set on or off. This assists 
in the load-ahead technique. 

The entry type 1 chain in the dictionary 
is then scanned. For each PROCEDURE entry 
in the chain, each entry label is examined 
for a completed declaration of the type of 
data the entry point will return when 
invoked as a function. If this has 
previously been given in a DECLARE 
statement nothing further is done, 
otherwise entry type 2 and 3 dictionary 
entries are constructed from default rules 
(see Appendix C.2). If this default data 
description does not agree with the 
description derived from the PROCEDURE or 
ENTRY statement, a warning message is 
generated. 

At each PROCEDURE entry, the chain to 
the ENTRY statement entry type 1 is 
followed. Each statement is treated in a 
similar manner to that for a PROCEDURE 
entry type 1. 

The CALL chain is then scanned and, at 
each point in the chain, the dictionary is 
searched for the identifier being called. 

If the correct one is not found, a 
dictionary entry for an EXTERNAL procedure 
is made (see Appendix C.2), using default 
rules for data description. Before making 
the entry, the identifier is checked for 
agreement with any of the built-in function 
names. If there is agreement, a diagnostic 
message is generated, and a dummy 
dictionary reference is inserted. 
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If an identifier is found, it is 
examined to see if it is an undefined 
formal parameter. If it is, the formal 
parameter is made into an entry point, 
again using default rules for data 
description. If it is not, or if the 
declaration of the formal parameter is 
complete, the type of entry is checked for 
the legality of the call. A diagnostic 
message is generated if the item may not be 
called. In all cases, the item called is 
marked IRREDUCIBLE if it has not previously 
been declared REDUCIBLE. 


I Phase EW (EV) 


Phase EW is an optional phase, loaded only 
if any LIKE attributes appear in the source 
program. 

This phase scans the LIKE chain which 
has been constructed by Phase EK, and 
completes the dictionary entry for any 
structure containing a LIKE reference. 

When a structure in the LIKE chain is 
found, its validity is checked, and 
dimension data and inherited information 
are saved. The dictionary is scanned for 
the reference of the "likened" structure 
and the entry is checked for validity. 

This dictionary entry (see Appendix C.4) 
is copied into the dictionary, with 
alterations if there is a difference 
between the original structure and this 
structure with regard to dimensioned data. 
If both structures have dimensions a 
straight copy is made; if the structure 
with the LIKE attribute has dimensions and 
the likened structure has not, the 
dimension information is added to the copy; 
if the structure with the LIKE attribute is 
not dimensioned and the likened structure 
is, then the dimension data is deleted from 
the copy. 1 Inherited data is added to the 
copy. If an error is found, the structure 
with the LIKE attribute is deleted and a 
base element copy of the master structure 
is inserted instead. Where copies of 
entries occur which refer to dimension 
tables with variable dimensions, the 
dimension table entry is copied, and new 
second file dictionary entries and 
statements are created. Similar entries 
must be made if the structure item has been 
declared to be an adjustable length string, 
or has been declared with the INITIAL 
attribute . 

Finally, the newly completed structure 
is scanned by the ALIGN routine in phase 
EV, to provide correct explicit/inherited/ 
default alignment attributes for its base 
elements. 


Phase EY 


Phase EY is an optional phase which 
processes all ALLOCATE statements. 

The second file is scanned first and all 
pointers to the dictionary are reversed. 

All ALLOCATE statements using the DECLARE 
chain are then scanned, and the dictionary 
references of allocated items are obtained 
by hashing the respective BCD of each item. 
The attributes given on the ALLOCATE 
statement for an item are collected 
together. 

A copy of the dictionary entry of the 
allocated item is then -made (see Appendix 
C.4), and the ALLOCATE statement is set to 
point to it. The dictionary entry is 
completed by including any attributes given 
on the ALLOCATE statement, and copying any 
second file statements from the DECLARE 
chain which are not overriden by the 
ALLOCATE statement. 

In the case of an ALLOCATE statement in 
which a based variable is declared, no copy 
of the original dictionary entry is 
required. The BCD is replaced by the 
original dictionary reference. 

All pointer qualified references in the 
text are checked to determine that the 
qualified variable is based. For every 
occurrence of a variable with a different 
pointer a new dictionary entry is made. If 
the variable is a structure the entire 
structure is copied. A PEXP second file 
statement is made for the pointer and the 
'defined* slot in the new dictionary entry 
is set to point to it instead of to the 
declared pointer. 

The BCD of the pointer and the based 
variable in the text are replaced by the 
new dictionary reference followed by 
padding of blanks which will be removed by 
phase FA. 

The based variable can be the qualified 
name of a structure member. If this is so, 
the name is checked for validity. Only the 
first part or lowest level of the qualified 
name in the text is replaced by the 
dictionary reference of the member. It is 
preceded by a special marker to tell phase 
FA that a partially replaced name follows. 


Phase FA 


Phase FA scans the text sequentially. If, 
during the scan, qualified names are found 
with subscripts attached, they are 
reordered so that a single subscript list 
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appears after the base element name. The 
dictionary is scanned and references 
obtained for any identifiers which are 
contextually, file, event, pointer 
variables, or programmer-named ON 
conditions. If no reference is available, 
a new dictionary entry is made. The 
identifier is then replaced in the text by 
the dictionary reference. 

If a constant marker is found, the 
dictionary is scanned to check if the 
constant is present. If it is not, a new 
dictionary entry is made (see Appendix C.7) 
and the resulting reference replaces the 
constant in the text. 

If a P FORMAT marker is found, the 
dictionary is scanned for a picture entry 
in agreement. If there is no agreeing 
entry, a new dictionary entry is made (see 
Appendix C.7) and the picture chain is 
updated. The dictionary reference replaces 
the format marker in the text. 

The CALL chain is removed from CALL 
statements. The appearance of PROCEDURE, 
BEGIN, END, and DO statements results in 
adjustments to the level and count stacks. 
If statement introduction code bytes appear 
(such as SN, SL, CL, and SN2), the current 
statement number is updated. All data 
items associated with the PROCEDURE, BEGIN, 
ENTRY, and DECLARE statements are removed, 
leaving only the statement identification 
and the keyword. 


Phase FE 


When an identifier is found, the hash chain 
is used to scan the dictionary for a valid 
entry. If one is found, its dictionary 
reference replaces the identifier in the 
output text. If no valid entry is found, 
and the BCD does not agree with any entry 
in the tables of BCDs of PL/I built-in 
functions, then a dictionary entry is made 
as if the identifier was declared in the 
outermost procedure. However, if the BCD 
agrees with a function name, and it is not 
in a SETS position, a function entry is 
made in the dictionary, and its reference 
is used to replace the identifier. 

If a left parenthesis is found, the 
previous dictionary entry is checked for an 
array, function, or pseudo-variable. If it 
is one of these, the relevant marker is 
inserted in the text before the parenthesis 
(see Appendix D.l). 

Checks are also made for the positions 
of function references in assignment 
statements. Any dictionary references 
encountered in the input file are moved 
directly to the output file. 


PROCEDURE, BEGIN, DO, and END statements 
cause the current level count to be 
updated . 


Phase FI 


Phase FI scans the text and checks, where 
possible, the validity of dictionary 
references found. References in a GOTO 
statement are checked that they refer to 
labels or label variables and that the 
subsequent branch is valid. The code byte 
for GOTO is changed to GOOB (see Appendix 
D.l) if the branch is to a label constant 
outside the current PROC or BEGIN block. 

If the branch is to a label variable, GOOB 
is set up unless a label value list was 
given at the declaration, and all members 
of the list lie within the current block. 

List processing based variables in 
ALLOCATE, FREE, READ, WRITE, and LOCATE 
statements are marked as requiring a Record 
Dope Vector (RDV) . Variables in TASK and 
EVENT options on CALL statements are 
checked for validity. 

References are checked if they appear 
where a file is expected. Items in data 
lists are checked for validity, and Data 
Element Descriptors (DEDs) and symbol bits 
are set on for all variables found in the 
lists. 

Any errors which are found cause 
diagnostic messages to be generated and 
dummy references to be placed in the text 
in place of erroneous references. 


Phase FK 


Phase FK scans the attribute collection 
area for entries with the SETS attribute. 
The SETS lists in the dictionary entries 
are scanned, and their syntax checked. 
Identifiers are counted and replaced by 
their dictionary references. Constants are 
counted, converted to binary, and arranged 
in ascending order in the dictionary entry. 


Phase FO 


Phase FO makes a dictionary entry for each 
ON condition mentioned inside a block. For 
ON CHECK conditions multiple dictionary 
entries are made (see Appendix C.7), one 
for each BCD. If a similar condition is 
mentioned more than once in a block, only 
one dictionary entry is made for that 
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condition, except for file conditions, ON 
CONDITION, and ON CHECK, when separate 
dictionary entries are made for each 
different BCD name. 

SIGNAL and REVERT statements are treated 
in a similar manner to ON statements. 

The dictionary entries for each BCD name 
associated with file or CONDITION 
conditions are checked and, if in error, 
the ON, SIGNAL, or REVERT statement is 
replaced by an error statement. A 
diagnostic message is generated. 

The BCD name of each file entry referred 
to in ON, SIGNAL, and REVERT statements is 
examined. If the BCD is SYSIN or SYSPRINT, 
the dictionary reference of the file entry 
is placed in a slot in the communi cat ions 
region. 

A check is made to ensure that formal 
parameters do not appear in CHECK and 
NOCHECK lists. A single dictionary entry 
is created for each CHECK and NOCHECK list 
and a pointer to the entry is placed in the 
relevant entry type 1. 

When dictionary entries are made for 
CHECK lists, one of three different check 
codes is used depending on whether the BCD 
is an ENTRY LABEL, a LABEL CONSTANT, or a 
variable. 

List Processing POINTER and OFFSET 
variables in CHECK lists are treated as 
data variables. BASED variables may not 
appear in CHECK lists. 

A dictionary entry is made for the list 
processing AREA condition. This condition 
is always enabled and may not appear in a 
condition prefix. 

Dictionary entries are also created for 
each ON condition which is disabled for a 
particular PROCEDURE or BEGIN block, and 
for each ON condition whose status is 
changed within the block. Pointers to 
these dictionary entries are placed in the 
relevant entry type 1. 

All dictionary entries for ON conditions 
are placed in the AUTOMATIC chain for the 
relevant PROCEDURE or BEGIN block. 

A further, quite distinct, function of 
this phase is to substitute error 
statements for all statements containing 
dummy dictionary references (which have 
been inserted by previous phases on 
detecting a severe error). If a dummy 
reference is found in the second file, the 
compilation is aborted. 

Wherever an element of a label array is 
initialized by appearing as a statement 


label, an assignment to a compiler label 
has been inserted by the Read- In phase. 
Phase FO checks the validity of each such 
assignment; for each array with this type 
of initialization, a second file dictionary 
entry is made, and all assignments to the 
array are chained. 


Phase FO 


Phase FQ checks the validity of each item 
in the PICTURE chain in the dictionary (see 
Appendix C . 7 ) . 

The precision for each correct picture 
is calculated, together with its apparent 
length, and stored in its dictionary entry. 
A data byte is created in the entry for use 
by Phase FT. 

Invalid pictures cause appropriate 
diagnostic messages to be generated. 


Phase FT 


Phase FT performs certain housekeeping 
tasks. These are as follows: 


1. The second file entries are scanned 
and pointers to each entry are 
inserted in the associated dictionary 
entry (see Appendix C.7). 

2. Each item which has a storage class is 
inserted into the appropriate chain 
for that class (see Appendix C.4). 

3. Constants are placed in the constants 
chain and "their apparent precision is 
calculated. Sterling constants are 
converted to pence. 

4. Dimension tables are separated for 
items which are not in structures, but 
which are arrays having similar 
bounds, but with different element 
lengths . 

5. Items which are members of structures 
and which have "inherited" dimensions, 
i.e. are contained in a structure 
which itself is dimensioned, are made 
to inherit their dimensions. If a 
base element of a structure inherits 
dimensions which are not constant, 
second file statements (see Appendix 
D.8) are set up to initialize the 
bounds in the object time dope vector. 

6. Items which have expressions to be 
evaluated at prologue time, e.g. 


38 



parameter descriptions for entry 
points and defined items, are placed 
in the AUTOMATIC chain for the 
appropriate block. 

7. The dictionary entry for any item 
described by a picture is expanded by 
the precision and scale or string 
length, extracted from the picture 
table entry. Identifiers of different 
modes sharing the same picture table 
are now placed in separate tables. 

8. The 'dope vector required' bit (see 
Appendix C.5) is set on where 
necessary. 

9. when a label array is found which has 
initial label statements for any of 
its elements, the chained statements 
are moved into the second file. The 
original statement is left in the 
text, to be removed by Phase FV. 

10. Dictionary entries similar to label 
ECD entries are made for all TASK 
variables. 


Phase FV 


Phase FV scans the second file and reverses 
the pointers to the dictionary. 

Dictionary entries for DEFINED data are 
completed (see Appendix C.4 and C.5). 
Overlay and correspondence defining are 
differentiated between, as are static and 
dynamic defining. A preliminary check of 
the validity of defining is also carried 
out. 

when PROCEDURE and BEGIN statements are 
encountered, any second file statements 
associated with data in the AUTOMATIC chain 
for that block are inserted in the text 
following such statements. 

When ALLOCATE statements are found, any 
second file statements associated with the 
item being allocated are inserted in the 
text following the statement. 

When a reference to dynamically defined 
data is found, the base reference is 
inserted into the text following the 
defined reference. 

When an initial label statement is 
encountered in the main text, it is not 
copied into the output string. 

The dictionary reference of a POINTER in 
a PEXP (pointer expression) second file 
statement is inserted into the defined slot 
of the associated based variable. If the 


based variable is a structure this 
reference is propagated throughout the 
structure. The PEXP statement is then 
deleted. 

A similar procedure is performed for 
BVEXP (based variable expression) second 
file statements whereby the dictionary 
reference of the AREA is inserted into the 
dictionary entry of the associated OFFSET 
variable. 

ADV second file statements referring to 
a BASED variable are checked for compliance 
with the (F) implementation rules. If the 
rules are obeyed, the dictionary entry of 
the 'bound' variable is inserted in the 
appropriate slot in the multiple table 
entry. 

If an MTF statement refers to a based 
variable the appropriate bound slot is 
copied from one multiple table entry to the 
other . 


Phase FX 


Phase FX is an optional phase entered only 
if the ATR (attribute list) or XREF 
(cross-reference list) option is specified. 
It scans the STATIC, AUTOMATIC, and 
CONTROLLED chains, and the formal parameter 
lists. 

For each identifier it creates an entry 
in text scratch storage of the form: 

2 bytes 3 bytes 3 bytes 

| Dictionary |Text reference | Text chain | 
j reference jto this item j j 

This entry is inserted into a chain of 
similar entries in the alphabetical order 
of the BCD of the identifier. 

If the XREF option is specified, the 
text is scanned for dictionary references. 
When the dictionary reference of an 
identifier is found in the text, an entry 
is created in a chain of entries from the 
dictionary entry of the identifier. If the 
identifier is that of a BASED item, an 
entry is also created in a chain of entries 
from the dictionary entry of the associated 
pointer . 

Each chain member thus represents a text 
reference to an identifier and has the 
form: 

2 bytes 3 bytes 

| Statement number | Text chain | 
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Each reference chain for an identifier 
is in text scratch storage. 

The sorted chain of identifiers is then 
scanned, and for each entry in the chain 
the following actions take place: 

1. The statement number of the DECLARE 
statement, if any, in which the 
identifier was declared is printed 

2. The BCD of the identifier is printed. 

3. If the ATR option is specified, the 
dictionary entry of the identifier is 
analyzed and its attributes are 
printed. For variables having 
constant dimensions and/or constant 
string lengths, these dimensions and 
lengths are printed. 

Except for file attributes, the 
attributes printed will be those 
obtaining after conflicts have been 
resolved and defaults applied, since 
the file attribute analysis does not 
take place until after the attribute 
list has been prepared (see Phase GA) , 
file attributes in the list are those 
supplied by the programmer, regardless 
of conflicts. 

4. If the XftEF option is specified, the 
reference chain for the identifier is 
scanned, and the statement number 
contained in each entry is printed 

Finally, all scratch storage is released 
and control is passed to the Pretranslator 
Phase. 


THE PRETRANSLATOR LOGICAL PHASE 


The purpose of the Pretranslator Phase is 
to expand those statements in the language 
that can be broken down into simpler 
statements, and to insert explicitly 
generated statements in place of implied 
ones. 

Second level markers (see Appendix D.l) 
are removed from internal compiler codes, 
and some of the I/O statements are changed 
into a form more suitable for the 
pseudo-code phase. 

Argument lists are examined and the 
matching of arguments with parameter 
descriptions takes place, with temporary 
variables being created where necessary, 
e.g., where data conversions are required. 

If the compilation contains ON CHECK 
conditions the appropriate calls to the 
library routine are provided. 


Any structure assignments containing the 
BY NAME option are processed. 

If any structure assignment statements 
or structures in I/O lists are detected in 
the program, they are expanded into scalar 
assignments and DO groups. 

If the program contains any array 
assignments, or array expressions in I/O 
lists, these are expanded into DO loops and 
scalar assignments or expressions. 

If the program contains iSUB references, 
the subscripts are computed for the base 
array corresponding to the subscripts given 
for the defined array. 


Additions to the Text 


In addition to changing the content of the 
text, the Pretranslator introduces some new 
symbols and grammatical forms into the 
source text. These are as follows: 

The Umbrella Symbol; this is 
designated by the symbol code X* 5E', 
which is used to introduce a literal as 
an operand. It is used only as a bound 
of a DO loop, or in a call of the dope 
vector pseudo-variable. 

Statements within statements: a list 
of statements may be introduced within 
another statement. In this case the 
inserted list is enclosed in 
parentheses. Statements in the list 
are given no statement number field, 
but they have semi-colons at the end. 

I/O statements: the form of I/O 
statements is changed considerably 
during the pretranslator phases, as 
explained in the description of Phase 
GB. 

BUY and SELL statements: special 
statements are introduced for 
manipulating temporary storage at 
object time: they have a form similar 
to ALLOCATE and FREE statements. 

Temporary Storage: Pretranslator 
phases create temporary variables for 
function and procedure calls where the 
arguments do not match the final 
parameters, where expressions appear as 
arguments, for control variables for DO 
loops in array and structure 
assignments, and for iSUB defined 
subscript lists. The Pretranslator has 
no mechanism for evaluating 
expressions. Therefore, temporaries 
which have no data type are created for 
expression arguments with no parameter 
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description. Such temporaries are 
known as 'chameleon' temporaries. The 
data type of these chameleon 
temporaries is completed by the 
Translator generic phase when the 
resultant data type of the expression 
has been determined. 


When the Pretranslator creates a 
temporary from an argument which 
contains any array with adjustable 
bounds or adjustable string length, 
compiler functions (see Appendix D.8) 
are generated in-line, to set up the 
adjustable quantities at object time, 
to enable storage of the correct size 
to be acquired by means of the BUY 
statement. 


The temporary variables created by the 
Pretranslator have dictionary entries 
similar to variables declared in the 
source program, except that the 
temporaries do not have BCD names. 


Phase GA 


Phase GA is an optional phase which scans 
the STATIC chain for file constants and 
OPEN control block entries. 

For file constants a DECLARE control 
block is constructed from the file name and 
attributes, while checking the attributes 
for consistency. For file constants with 
the ENVIRONMENT option a dictionary entry 
is constructed, chained from the file 
constant, containing the storage image of 
the 56-byte DECLARE control block. 

For OPEN control block entries an OPEN 
control block is constructed from the 
attributes in the entry, a check is made 
for consistency, and another dictionary 
entry, chained from the OPEN control block 
entry, is constructed. This new entry 
contains the 8-byte storage image of the 
OPEN control block. 

When the COBOL option is encountered in 
the ENVIRONMENT string of a FILE statement, 
phase GA sets the low-order bit in the 
fifteenth byte of the FILE dictionary 
entry. Although this action overwrites the 
dictionary reference of the ENVIRONMENT 
string, it is permissible since GA is the 
only phase which processes this string. 

The EXCLUSIVE second level marker is 
recognised in the file attribute dictionary 
entry during the diagnostic check and 
construction of the DCLCB or the OCB. 


Phase GB (GC) 


Phase GB, containing Modules GB and GC, 
processes I/O statements. GB removes all 
second level markers from internal 
character codes (see Appendix D.l). It 
then reorders the options so that either 
EDIT, DATA, or LIST options appear last. 

In data lists the DO specification is 
moved so that it precedes the relevant 
list, and the END statement is added. 

In format lists iteration factors are 
expanded. 

RECORD I/O statements for which the 
COBOL file option is recognized are 
examined for validity by GC. Diagnostics 
are put out for LOCATE and READ SET 
statements for which COBOL files are used. 

A temporary variable is created to assist 
such data transfers as occur when a COBOL 
record is read into or written from a 
structure which does not consist entirely 
of one of the followig: 

• doubleword data 

• fullword data 

• halfword binary data 

• character string data 

• aligned bit string data 

• a mixture of character string and 
aligned bit string data 

I/O activity found within a PROCEDURE or 
BEGIN block causes the bit X'10' to be set 
to one in the optimization byte of its 
entry type 1. 


Phase GK 


Phase GK scans the source text for function 
references. If it finds one, it inserts a 
special marker byte before the argument 
list, followed by: 

1. Two code bytes giving information 
about the type of function, and 
whether it was called with the TASK 
option 

2. The current statement number 

3. The current block level and count 

This phase also inserts a special 
argument marker before each argument in the 
list, followed by the reference of the 
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corresponding parameter and a code byte to 
show whether or not the argument is 
specified in a SETS list. The number of 
arguments present is checked against the 
number given as required by the 
corresponding dictionary entry. 

NULL, NULLO, and EMPTY built-in 
functions are recognised and converted to 
constants . 


Phase GO 


This phase acts as a pre-processor for 
phase GP. 


Phase GP 


Phase GP scans the text for procedure and 
function calls with arguments. These are 
detected by the special markers inserted by 
Phase GK. 

Temporaries (see Appendix C.4) are 
created for any arguments which are 
expressions. (An expression is defined as 
being any sequence of variables and 
operators, other than single variables 
followed only by a subscript list, or only 
by a defined subscript list and then a 
subscript list) . If a parameter 
description has been declared in an entry 
declaration, the temporary which is created 
is of the same type as the parameter 
description. Otherwise, a ’chameleon* 
temporary of unspecified data type is 
created, its type being subsequently 
completed when the expression type has been 
determined by the Translator generic phase. 

Expressions are scanned for arrays 
(including partially subscripted arrays), 
structures, or the end of the expression, 
in order to determine the highest form of 
aggregate in the expression, so that the 
correct type of temporary may be created. 

Where the expression contains a 
partially subscripted array, a temporary is 
created with a dimensionality equal to the 
number of cross sections specified in the 
subscript list. 

When single arguments are specified 
together with parameter descriptions, the 
arguments are compared with the parameter 
description. If there is a lack of match, 
action may be taken in one of two ways. 

1. If the data types are compatible, a 
warning message is printed, and a 
temporary is created 


2. If the data types are incompatible, an 
error message is printed, and the 
parameter description is ignored 


When the argument is a single partially 
subscripted array which matches the 
parameter, a special temporary is created 
which has the same dimensionality as the 
number of cross sections in the subscript 
list, and it appears to be defined upon the 
original argument. Code is then generated 
to initialize the temporaries, multipliers, 
and virtual origin from the dope vector of 
the original argument and the subscript 
list. 


Whenever a temporary is created, a BUY 
statement contained in nested statement 
brackets is inserted in the output text, 
followed by the assignment of the 
expression or non-matching argument to the 
temporary. After the end of the PROCEDURE 
or function call, all the temporaries 
generated in the call are released by means 
of a SELL statement in nested statement 
brackets . 


In all argument temporaries created by 
phase GP, other than those created for 
constants, a special flag bit is set on 
(see Appendix C.2), but in the case of 
temporaries created for arguments to 
built-in functions, this bit is turned off 
by phase IM. This bit is used in phase QU 
when halfword instructions replace fullword 
instructions in the manipulation of 
halfword binary operands which are 
temporary arguments. 

Temporaries are created for constants 
which are specified as arguments to 
functions defined by the programmer. 

If a TASK, EVENT, or PRIORITY option is 
present in a CALL statement, then any 
temporaries which are created are of the 
*not sold* type. 

If GENERIC entry labels are specified as 
arguments to procedures, a special 
dictionary entry is made which contains the 
argument and parameter description 
dictionary references, to enable the 
Translator generic phase to select the 
correct generic member. 

A warning message is printed whenever a 
temporary is created for an item declared 
in a SETS list. 

When subscript lists for the number of 
cross sections are being checked, a severe 
error message is printed if a subscript 
list contains too many subscripts, and the 
statement is deleted. 
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Phase GU 


Phase GU scans the source text for 
PftOCEDUFE, BEGIN, and END statements , and 
for statements that may raise a possible 
CHECK condition. 

A list of all items currently checked is 
extracted from the CHECK and NOCHECK lists 
present in PROCEDURE and BEGIN statements. 

Items contained in statements that may 
raise a CHECK condition are examined and 
compared with the list of currently checked 
items. If the item appears in the list, a 
SIGNAL CHECK statement is created for it, 
either before the statement concerned (for 
labels and entry names) or after it (for 
variables) . 


Phase HF 


The purpose of phase HF is to detect 
structure assignment statements, possible 
structure expressions in data lists in GET 
and PUT statements, and nested statements, 
in particular nested structure assignments. 

The leftmost structure in an expression 
or assignment is used as a basis for 
comparison, and if similar structuring is 
not found throughout the expression or 
assignment, diagnostic messages are issued. 
Any expression containing no structures is 
left unchanged. 

The base elements of the structures are 
found, and if the referenced structures are 
dimensioned, a temporary is created for 
each dimension. It is then added to the 
AUTOMATIC chain for the appropriate block. 
Iterative DO loops are constructed, with 
the temporaries iterating between the upper 
and lower bounds of that particular 
dimension. Base elements are assigned, 
with the temporaries as subscripts, and 
with scalars remaining unchanged. END 
statements are created for the DO loops, 
and 3&LL statements for the temporaries. 

Tne statenents which have been created are 
nested within the original statement. 


Phase HK 


The purpose of Phase HK is to detect array 
or scalar assignments, possible array 
expressions in I/O lists in GET and PUT 
statements, and nested statements, in 
particular nested assignment statements. 


The leftmost array in an expression, or 
the leftmost array or scalar in an 
assignment is used as a basis for 
comparison, and if similar dimensions or 
bounds are not found in the array 
references, diagnostic messages are issued. 
Any expression containing only scalars is 
left unchanged. 

For unsubscripted arrays which are 
equally spaced in storage only one 
temporary is bought. For all other arrays 
a temporary is bought for each dimension, 
except in the case of certain partially 
subscripted arrays where the number may be 
minimized. Each temporary will be added to 
the AUTOMATIC chain for the appropriate 
block. If the ON-condition name 
SUBSCRIPTRANGE is enabled for any 
statement, a temporary will be bought for 
each dimension in all cases. Iterative DO 
loops are constructed: for an unsubscripted 
array expression of dimensionality N, the 
temporary will iterate between the lower 
bound of the Nth dimension and an evaluated 
product so that all elements of the array 
are processed; while for other arrays the 
temporaries will iterate between the lower 
and upper bound of the particular dimension 
of the array. The assignment statement is 
added to che output string with additional 
subscripts where necessary. End statements 
are created for the DO loops, and SELL 
statements for the temporaries. The 
statements which have been created are 
nested within the original statement. 

The syntax of pseudo-variables is also 
checked. 


Phase HP 


Phase HP scans the source text for 
references to items defined using iSUBs. 

For each reference found, the subscripts 
are computed for the base array 
corresponding to the subscripts given for 
the defined array. 

The subscripts of the defined -array are 
assigned to temporaries specially created 
for this purpose, which are then used to 
replace the iSUBs in the defining subscript 
list. The base array, with the subscript 
list so formed, replaces the defined array 
in the text. 


THE TRANSLATOR LOGICAL PHASE 


The Translator Phase consists of two 
physical phases, the stacker phase and the 
generic phase. The purpose of the 
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Translator is to convert the output from 
the Pretranslator into a series of 
"triples" (see Appendix D.4). A "triple" 
is in the form of an operator followed 
normally by two operands. 

The translation is achieved by using a 
double stack, with one part for operators, 
and the other part for operands, and 
assigning two weights to each operator. 

One weight (the stack weight) applies to 
the operator while it is in the stack, and 
the other weight (the compare weight) 
applies when the operator is obtained from 
the input string. 

When an operator is obtained from the 
input string it is compared with the top 
stack operator. Depending on the result of 
the comparison, one or other of the two 
operators is switched on to determine what 
action is next to be performed. Apart from 
some special cases, this action is usually 
either to continue to fill the stack, or to 
generate a triple. The special cases lead 
to various manipulations of the stack 
items, after which the translation process 
continues . 

For the purposes of translation, the 
input text to the translator is considered 
to consist of operators and operands only. 
This means that I/O options, etc., are 
regarded as operators. 

After translation, the text string 
consists of operands and operators. All 
statements start with an operator to 
indicate a statement number or label, 
followed by the statement type, which may 
be a single operator, as in the case of 
RETURN or STOP, or which may be an operator 
such as a function or subscript marker, 
followed by a list of arguments. This list 
may also include compiler generated 
statements, e.g., DO loops for I/O lists. 
All I/O options are regarded as operators 
and require no markers before them. The 
end of the source text will be marked by a 
special operator, and compiler generated 
code, which may follow this end-of-program 
marker, will appear between the marker and 
the special second-end-of- program marker. 
The end of a block of text will be marked 
by an EOB operator. The program is now 
assumed to be syntactically correct. 


Phase IA 


Phase IA rearranges the source text into a 
prefix form, in which parentheses and 
statement delimiters have been removed, and 
the operations within a statement have been 
so arranged that those with the highest 
priority appear first. 


As operators and operands are 
encountered, they are stored in stacks. 
Tables give the priority of each operator 
as it appears in the input text and in its 
stack. 


When an operator is found during the 
scan of the source text, its compare weight 
(see Appendix D.4) is tested against the 
stack weight of the top operator in the 
stack. If the compare weight is the lesser 
of the two, then action is taken according 
to the compare operator. This is referred 
to as the compare action. Similarly, if 
the compare weight for the current operator 
found in the scan is greater than or equal 
to the stack weight of the top stack 
operator, action is taken according to the 
top stack operator. This is referred to as 
the stack action. Normally, the compare 
action is to place the compare operator in 
the stack, and to continue the scan, 
placing any subsequent operand in the stack 
until another operator is found. The 
normal stack action is to generate a 
triple, consisting of the top operator in 
the stack and the top two operands, 
eliminating the items from the stack, and 
inserting a special flag as the operand of 
the triple which is now at the top of the 
stack. The source (compare) item is then 
compared with the new top stack item. 


The output text of the stacking phase is 
in the form of a series of triples, i.e. 
statement types with no operands, and 
operators with one or two operands. If the 
result of a triple operation is to be used 
in a later triple, the appropriate result 
is flagged accordingly. 


Certain phases are marked wanted or not 
wanted at this stage. If the source text 
contains an invocation by CALL or function 
reference. Phases IL and IM are marked 
wanted. If it does not. Phases IL, IM, IN, 
10, IP, IQ, MG, MH, MI, MJ, MK, MM, MN, and 
MO are marked not wanted. Phases MB and MC 
are marked wanted when the source text 
contains pseudo- variables or multiple 
assignments; otherwise, they are marked not 
wanted. The DO loop processing phases (LG 
and LH) are marked in co-operation with the 
dynamic initialization phases (LB and LC) . 
If LB and LC are requested, the marking of 
LG and LH is left until that stage of 
compilation; otherwise, LG and LH are 
marked by Phase IA independently. 


When ALLOCATE and FREE statements occur, 
phase NG is marked wanted. When LOCATE 
statements occur, phase NJ is marked 
wanted. 
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Phase IG 


Phase XM 


Phase IG is an optional phase which is 
loaded to process array and structure 
arguments to built-in functions. When 
aggregate arguments are given for built-in 
functions they are expanded by the 
structure and array assignment phases so 
that the built-in functions appear as base 
elements, subscripted where necessary. 


Phase GP examines these arguments, and 
ascertains whether it is necessary to 
create a dummy. If it is necessary, a 
scalar dummy is created, but the assignment 
of the argument expression is not inserted 
in the text, as this would be an invalid 
aggregate assignment. 


Phase IG examines the text for a BUY 
statement for a dummy for an aggregate 
argument to a built-in function, and then 
inserts an assignment triple in the correct 
place in the text. 


Phase IK 


This phase immediately precedes the phase 
IL and shares with it the initialization 
processes required by tne main generic 
phase IM. It obtains text block storage 
and moves into it routines and a table that 
will be used later by the main generic 
phase. Part of the storage is reserved for 
use by the main generic phase as a nested 
function stack area, control is passed to 
phase IL. 


Phase IL 


This phase immediately precedes the main 
generic phase IM and completes the 
initialization process begun by phase IK. 

It obtains 4K bytes of scratch storage and 
places in it the entire built-in function 
table and a list of constants used by the 
main generic phase. Registers are set to 
point to the built-in function table, to 
the list of constants, and to the nested 
function stack area reserved by phase IK. 
Further text block storage is obtained for 
use by the main generic phase and a 
register is set to point to it. Control is 
passed to phase IM. 


This phase is the main generic processor. 

It scans the source text for procedure 
invocations by a CALL statement, procedure 
or library invocations by a function 
reference, and assignments to "chameleon" 
dummy arguments (see Phase GP) . 

Any procedure which is generic and is 
invoked by a CALL statement or function 
reference is replaced by the appropriate 
family member. If the invoked procedure is 
non-generic, it is ignored. A generic 
library routine invoked by a function 
reference is also replaced by the 
appropriate family member. 

The arguments passed to library routines 
are checked for number and type, and a 
conversion inserted where necessary and 
possible. 

The type and location of the result of 
all function invocations is placed in the 
text which follows the end of the text 
which invoked the function. The resulting 
type of an expression assigned to a 
"chameleon" dummy is determined and set in 
the dictionary entry which relates to the 
dummy. 

The argument bit, set on for all 
argument temporaries created by phase GP, 
is turned off for arguments of built-in 
functions. 


Phase IT 


Phase IT scans the source text for function 
triples and, in particular, the built-in 
functions for which code will be generated 
in-line. Further tests are made to detect 
the functions which, according to the 
method used to generate in-line code, are 
optimizable. This applies only to the 
SUBSTR, UNSPEC, and INDEX functions. All 
references to 'chameleon' temporary 
assignments within the scope of these 
functions are removed subject to certain 
restrictions imposed by the function 
nesting situation. 


Phase IX 


Phase IX checks that POINTER and AREA 
references are used as specified by the 
language. This phase is loaded only if 
POINTER or AREA references are found, 
declared either explicitly or contextually. 
Error messages are produced if errors are 
found and the statement in error is erased. 
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Data type triples in the text are 
scanned and a stack of temporary results is 
created containing the values: 

X * 40 * for POINTER 

X* 02* for AREA 

X * 00 ' for any other data type 

The maximum permitted number of 
temporaries at any one point in a program 
is 200. The compilation is terminated if 
this figure is exceeded. 


Phase JD 


Phase JD scans the text for concatenation 
and unary prefixed triples with constant 
operands. These are evaluated and the 
results are placed in new dictionary 
entries. The references are passed through 
a stack into the corresponding result slots 
in the text. 


THE AGGREGATES LOGICAL PHASE 


The Aggregates Phase consists of three 
physical phases, the preprocessor (phase 
JI), the structure processor (phase JK) and 
the DEFINED chain check (phase JP) . 

The structure processor phase carries 
out the mapping of structures and arrays in 
order to align elements on their correct 
storage boundaries. 

The DEFINED chain check ensures that 
items DEFINED on arrays and structures can 
be jnapped consistently. 


Phage Ji 


The first function of phase JI is to obtain 
scratch storage in which the text skeletons 
contained in phase JJ are to be held. 

Pnase JJ is then loaded, and its contents 
are moved to the scratch storage for 
subsequent use by phases JI and JK. Phase 
JJ is then released and control is returned 
to phase JI. 

The main function of phase JI is to 
expedite data interchange activities. A 
scan of static, automatic, and controlled 
chains is performed. The chains are 
reordered so that all data variables appear 
before non-data items. Adjustable PL/I 
structures and arrays are detected. Each 
entry in tne COBOL chain is mapped as far 
as possible at compile-time, removed from 


the chain, and placed in the appropriate 
AUTOMATIC chain. 


Phase JK 


This phase scans the AUTOMATIC, STATIC, and 
CONTROLLED chains for arrays, structures 
(including COBOL structures), adjustable 
length strings, DEFINED items, AREA, and 
POINTER arrays and structures, TASK and 
EVENT arrays, and TASK and EVENT arrays in 
structures . 

For the base elements of structures 
without adjustable bounds or string 
lengths, the following calculations are 
made: 

The offset from the start of the major 
struct tire 

The padding required to align the 
elements on the correct boundary 

All multipliers of arrays of 
structures. 

For all minor structures and major 
structures the following calculations are 
made: 

Size 

The offset from the preceding alignment 
boundary with the same value as the 
maximum appearing in the structure 

Where a structure contains adjustable 
bounds or string lengths, code is generated 
to call the Library at object time. 

For arrays, the multipliers are 
calculated, unless the array contains 
adjustable items, in which case the Library 
performs the calculations. 

For adjustable structures, arrays, or 
strings, code is generated to add a 
symbolic accumulator register into the 
virtual origin slot of the dope vector, and 
the accumulator register is incremented by 
the size of the item. 

Calculations are made in a similar 
fashion for arrays of strings (in 
structures or otherwise) with the VARYING 
attribute. In addition, code is generated 
to set up an array of string dope vectors 
which refer to the individual strings in 
the array using the dope vector. Code is 
also generated to convert the original dope 
vector to refer to the array of string dope 
vectors, instead of to the storage for the 
array. 
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The routine which generates code for 
arrays of VARYING strings is also used to 
generate code for the initialization of 
arrays of TASK, EVENT, and AREA variables. 

DEFINED items are processed in the 
following ways 

Code is generated to set the 
multipliers and virtual origin address 
of correspondence defined arrays 
without iSDBs in the dope vector of the 
DEFINED items from the defining base 
dope vector. 

Code is generated for overlay DEFINED 
items if they do not fall into the 
class which is to be addressed 
directly. The code first maps the 
DEFINED item, if necessary, calculates 
the address of the start of the storage 
to be used by the DEFINED item, and 
finally, relocates the DEFINED item 
using this address. 

Dope vector descriptor dictionary 
entries and record dope vector dictionary 
entries are made for items which need to be 
mapped at object time, or which appear in 
RECORD-oriented input/output statements. 


Phase JP 


Phase JP scans the DEFINED chain, and 
differentiates between the following: 

1. Correspondence defining 

2. Scalar overlay defining 

3. Undiirensioned structure overlay 
defining 

4. Mixed scalar-array- structure- string 
class overlay defining 

In correspondence defining, this phase 
differentiates between arrays of scalars 
and arrays of structures. It also checks 
that the elements of the defined item which 
may validly overlay the elements of the 
base belong to the same defining class, and 
that the base is contiguous. 

In scalar overlay defining, this phase 
checks that the defined item may validly 
overlay the base. 

For undimensioned structure overlay 
defining, this phase checks that the 
elements of the defined item may validly 
overlay the elements of the base. 

For mixed scalar-array-structure-string 
class overlay defining, this phase checks 


that all elements of the defined item and 
all elements of the base belong to the same 
defining class (bit or character) , and that 
the base is contiguous. 


THE OPTIMIZATION LOGICAL PHASE 


The optimization logical phase consists of 
several physical phases and is loaded if 
0PT=2 is specified in the PARM field of the 
EXEC statement. 

The work done during the Optimization 
Phase can be split into two parts. The 
first consists of testing the text and 
dictionary to see if optimization is 
permissible. As a result of these tests, 
tables are built pointing to optimizable 
text. The second part consists of code 
generation and modification reguiring 
scanning of the tables built in the first 
part, and direct references to the text and 
dictionary. 

All code generation resulting in text 
expansion is placed in a patch file, and 
the point of insertion in the text is 
overwritten with a PTCH triple pointing to 
the patch. The last physical phase merges 
the patch text into the main program text. 

Optimized code is produced for subscript 
address calculations and iterative DO-loop 
control. In the case of subscripts most of 
the optimized code consists of reordered 
triples, but optimized loop control code is 
generated as pseudo-code using BXLE, and 
BXH instructions. 

Only simple loops and subscript lists 
are optimized, and the variables involved 
must be real, fixed binary, scalar integers 
and the constants must be decimal integers. 

The two main problems in deciding 
whether it is permissible to optimize code 
are: 

1. Aliasing of variables 

2. The action of the program for 
exceptional conditions 

Optimization is inhibited where it is 
difficult, or impossible, to decide that 
optimization will produce an object program 
which will execute according to the rules 
of PL/I. The keyword REORDER, indicates to 
the Optimization Phase, that ON-units for 
exceptional computational conditions may be 
ignored. This enables more cases to be 
optimized than for the default setting of 
ORDER. 


Chapter 2: The Compiler Logical Phases 47 



Three types of subscript optimization 
are performed: 

1. Transformation Where possible, a 
control variable used as a subscript 
is transformed such that, instead of a 
•subscript * multiplier + virtual 
origin* address calculation, each 
iteration produces a simple increment 
of a register to access the next 
element. 

2. Invariance Where possible, an 
invariant subscript calculation inside 
a DO- loop is moved outside. 

3. Comrooninq Where possible, a common 
subscript expression is only 
calculated once and this value is 
placed in a register to be used at 
later occurrences. 

For array expressions an attempt is made 
to combine the incrementing of a 
transformed control variable with the BXLE 
or BXH of the optimized loop control code. 

The text is optimized starting from the 
innermost of a nest of iterative DO- loops 
and working outwards. This enables patch 
code, which moves out of a DO- loop, to be 
included in the processing of the enclosing 
DO- loop, hence moving out code as far as 
possible in a nest of loops. 


Phase KA, (KB) 


Contains utility routines and common data 
space used by the later optimization 
phases. Details of the utilities are given 
in Appendix K. 

The utilities enable the optimization 
phases to build and process tables in text 
blocks without concern for physical block 
boundaries, status of text blocks, or 
maintaining pointers to first, last, and 
current table entries. 

The facilities provided: 

1. Define a table using a table control 
block area. 

2. Add new entries to the end of a table. 
Table entries may be of fixed or 
varying length and a table can contain 
more than one type. 

3. Scan a table forwards or backwards. 

4. Make direct reference to table 
elements . 

5. Delete a table. 


6. Specify locking of entries. 

7. Remove all locks on table entries. 


Phase KC 


Phase KC scans the text for DO-loop 
specifications. If the loop is potentially 
optimizable, then any expressions in the 
initial, the TO, or the BY specifications 
are assigned to temporary variables. The 
expression and the assignment are moved 
outside the loop and are replaced in the 
specification by a simple reference to the 
temporary variable. 

Text is also scanned for ON-units. The 
occurrence of each type of ON- unit is 
recorded by the appropriate bit in the mask 
used by Phase KG. 


Phase KE 


Phase KE performs a scan of the dictionary 
and a scan of the text. The purpose of 
these scans is to mark variables 'unsafe' 
if they can possibly be affected by changes 
to other variables (i.e., aliases). 
Variables are marked unsafe if they are 
EXTERNAL, DEFINED, defined upon, BASED, or 
PARAMETERS, or if they are (or might be 
through being arguments of procedure calls) 
arguments of the ADDR built-in function. 

In addition, during the text scan, the 
DO MAP table is created. This table 
contains an entry for each DO-loop and 
procedure in the source text. Each entry 
contains information describing the loop or 
procedure and giving its location in the 
text. A chain is constructed through these 
entries giving the order in which they are 
to be processed by subsequent K phases. 


Phase KG 


Phase KG scans the text corresponding to 
each DO MAP entry in turn and builds up two 
lists which are chained off the DO MAP 
entry. The USE list is a list of all the 
real, fixed binary, scalar integer 
variables which are used within the loop. 

A flag byte indicates whether the variable 
is assigned to or is invariant in the loop. 

The SUBS/REGION list consists of two 
types of entry: 

1. A SUBS entry which contains the text 
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Phase KN 


reference of a SUBSCRIPT triple 
referring to an array for which 
SUBSCRIPTRANGE is not enabled. 


2. A REGION entry which contains the text 
reference of a triple which results in 
an assignment to one or more 
variables. There are four types of 
REGION boundaries : 


a. A GLOBAL region boundary which 
contains the text reference of a 
point where the value of any 
variable could be changed. 


b. A PARTIAL SAFE boundary which 

contains the text reference of a 
point where an assignment is made 
to a variable which is a SAFE real 
fixed binary scalar integer, 
followed by the dictionary 
reference of this variable. 


c. A PARTIAL UNSAFE region boundary 
which contains the text reference 
of a point where an assignment is 
made to an UNSAFE variable (not 
just a scalar) . The dictionary 
reference is not inserted in this 
case. 


d. An ITDO region boundary which 

contains the text reference of an 
ITDO triple corresponding to an 
enclosed loop. 


Phase KJ 


Phase KJ creates the SUBS TABLE from the 
SUBS/REGION list produced by phase KG. The 
DO NAP created by KE provides the order of 
processing and further information. 

The Region entries from the SUBS/REGION 
list are copied directly into SUBS TABLE 
whenever they occur. The SUBS entries from 
the list are expanded to contain 
information on the type of expression 
involved at this point. The USE list 
created by KG provides information during 
this analysis. The SUBS/REGION list is 
deleted by this phase. 

The iterative specification triples of 
each DO-loop are inspected, and the spare 
operands used to set flags to indicate 
whether this loop is optimizable for BXLE 
or BXH loop control code. 


Phase KN provides initialization of the 
scratch storage area used by phase KO. 

An initial text scan is made in DO MAP 
sequence, to remove offsets from 
optimizable subscript lists and produce 
hash totals for optimizable subscript 
expressions. The hash totals are placed in 
the SUBS/REGION table and are used in phase 
KO to speed up the matching process. 


Phase KO (KP,KQ) 


Phase KO processes text in the order 
specified in the DO MAP, i.e., working 
through a nest of iterative DO- loops and 
procedures from innermost outwards. 

The three types of subscript 
optimization: transformation of the control 
variable? invariance; and commoning; are 
performed and optimized code is generated 
and inserted in a patch file. The code to 
be replaced in the original text is 
overwritten with NOP*s and a PTCH triple 
points to the patch text. 

All three types of subscript 
optimization require searches for multiple 
occurrences of the same expression in the 
text. This is done by scanning the SUBS 
TABLE for matching triple expressions in 
optimizable subscript lists. When a match 
is found a chain is constructed in the SUES 
TABLE between the matched elements. The 
code is generated for one chain at a time) 

Code generated for optimized subscripts 
may be inserted: 

1. Before the ITDO triple, i.e., where an 
invariant subscript calculation is 
moved out of a loop or where the 
initial setting of a transformed 
control variable is required. 

2. Before the ITD* triple, i.e., for the 
incrementing code of a transformed 
control variable. 

3. After the ITD' triple, i.e., the 
DROP'S for symbolic registers used in 
the optimized code. 

4. At the point of use in the subscript 
list. 

For array expressions the incrementing code 
for a transformed control variable will be 
deleted if a BXLE or BXH can be generated 
which will increment the transformed 
control variable and control the number of 
iterations of the loop. 
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USSL declarations may be inserted in the 
optimized code to indicate that registers 
have priority and need not be saved and 
restored at branch points. The register 
allocator phase gives these registers 
priority over normal symbolic registers. 


Phase KT 


Phase KT is a renamed replacement of phase 
LA which is now obsolete. It is always 
loaded. This phase is a utility phase 
which remains in storage throughout the 
remainder of the Optimization Phase and the 
whole of the Pseudo-Code Phase. It 
provides the main scanning routines to 
handle input and output of text containing 
triples and pseudo-code. 

The routine/subroutine directories in 
Chapter 3 give a complete list of the 
routines provided, together with brief 
descriptions of their functions. 


Phase KU(KV) 


Phase KU has three main functions performed 
during a single text scan. 

The first function is DO- loop control 
optimization. Each ITDO triple encountered 
during the text scan is checked to 
determine whether or not it has been 
flagged as being optiraizable by a previous 
phase. If not flagged the scan is 
continued. All DO- loop control 
specifications headed by an ITDO triple 
flagged as optimizable are replaced in text 
by an optimized pseudo-code group using the 
BXE and BXLE instructions. There are three 
basic forms to this optimized pseudo-code 
control specification, the particular one 
used for any loop depending on the type of 
step. 

The second function is to detect each of 
the PTCH triples inserted into text by a 
previous phase. The corresponding patches 
are obtained from patch file text blocks 
and are processed as necessary before being 
inserted into text in place of the PTCH 
triple. 

The last function is that of the 
subscript list processing. Each innermost 
subscript list encountered, as indicated by 
the presence of a SUBS triple in the main 
text, is checked for the occurrence of COMA 
or CCKR triples within it. The SUBS triple 
is then altered as may be necessary. 


THE PSEUDO— CODE LOGICAL PHASE 


The Pseudo-Code Phase accepts the output of 
the Translator Phase, and converts the 
triples into a series of machine-like 
instructions. The transformation into 
pseudo- code is achieved by a series of 
passes through the text; each pass removes 
certain triples and replaces them by 
pseudo- code, until the entire text is in 
pseudo-code form. On completion of this 
phasd, control is handed to the Storage 
Allocation Phase. 


Pseudo- Code Design 


Pseudo-code is essentially a one-for-one 
symbolic representation of machine code, 
designed so that it can be transformed 
directly into executable machine code by an 
assembly process. 

Pseudo-code is constructed in basic 
units, the majority of which have a 
standard size of three or five bytes. A 
variable sized unit, however, is also 
available to allow flexibility, its length 
being specified by a length code within the 
unit. The formats of pseudo-code 
instructions are shown in Appendix D.6. 

A unit consists of a one-byte operation 
code followed by normally, a two- or 
four-byte field, or on the other occasions 
by a variable length field. The bit 
pattern of the operation code indicates the 
type of unit which it heads. 


Pseudo-Code Items 


In addition to there being one pseudo- code 
item for each machine instruction which 
could be generated, there are also 
pseudo- code items which are produced to 
convey information from one phase of the 
compiler to another. 

These items of information have the same 
format as a pseudo- code item, so that the 
handling and scanning of the source text is 
standardized. They do not, however, appear 
in the final object code. 


Register Description 


In all cases where a general purpose 
register appears in pseudo-code, it will be 
described symbolically. When conventional 
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registers are required in, for example, 
calling sequences, the registers will be 
referred to physically, as they will be in 
all cases of floating-point register usage. 


The Use of Symbolic Unassicmed Registers 


Whenever a new register is required while 
pseudo-code is being generated, a symbolic 
register counter is incremented by one and, 
subject to this new value not being greater 
than 16,383, it is used as the symbolic 
name of the required register. When this 
register is no longer required a DROP 
pseudo-code item is inserted into the text 
to indicate to the Register Allocation 
Phase that the physical register allocated 
to this symbolic register may be 
reassigned. 


The Use of Physical Registers 


Physical general purpose registers will be 
used either as arithmetic registers or as 
parameter registers. 

With arithmetic registers, it is the 
responsibility of the pseudo-code 
generation phases to save and restore the 
registers as necessary. This will apply 
both to the general purpose arithmetic 
registers (namely 14 and 15) and to the 
four floating-point registers. Although 
this is of primary interest to the 
expression evaluation phases, it should be 
realised that all phases which generate 
calling sequences must be aware of the 
current status of arithmetic registers, and 
generate code to save and restore them as 
necessary. 

In the case of parameter registers, 
however, the Register Allocation Phase will 
be able to save and restore them as 
required. 


Temporary Descriptors 


As expressions are evaluated, a series of 
intermediate temporary results are 
obtained. These results, or their 
addresses, may be contained in symbolic or 
assigned registers, in a dictionary 
reference, with or without an index 
register, or in workspace. Temporary 
descriptor triples (TMPD) are inserted in 
the text to enable the correct pseudo- code 
instructions to be generated from the 
triples. The format of TMPD triples is 
described in Appendix D.9. 


Temporary Workspace 


A block of temporary workspace is used to 
store intermediate results obtained in 
evaluating expressions at object time. 
Pseudo- code phases allocate the next 
available workspace location within the 
block, and then update the location 
pointer, whenever the necessity to save an 
intermediate result arises. The location 
of the intermediate result is then 
described for later phases by a TMPD in the 
text. Intermediate results are only 
required during the execution of single 
PL/I statements; they are never preserved 
from one statement to another. 


At the end of the pseudo-code phases the 
maximum size of the temporary storage 
required in each PL/I program block is 
placed in a dictionary entry. The required 
amount of workspace is then allocated in 
each Dynamic storage Area (DSA) by Phase 
PT. 


Phase LB 


Phase LB scans through the text for 
PROCEDURE, BEGIN, and ALLOCATE statement 
triples . 

Whenever one of these is found, a scan 
is made through the immediately succeeding 
second file statements; this is for any IDV 
(initial dope vector) statement referring 
to a variable replication factor in the 
array initial strings Processing of these 
statements and of the corresponding array 
initial strings is then carried out. 

On completion of this secondary scan, 
the action taken depends on which triple 
was originally found: 

1. For PROCEDURE or BEGIN triples, a scan 
is then made of the AUTOMATIC chain in 
the dictionary. For any scalar 
variables that have been declared 
INITIAL, a set of triples is created 
and inserted into the text. For any 
array declared INITIAL, the initial 
string is scanned, and a mixture of 
triples and pseudo-code is generated. 

2. For ALLOCATE triples, if the item has 
been declared INITIAL, the initial 
string is scanned, and a mixture of 
triples and pseudo-code is generated. 

Phase LB also marks Phase LG (DO-groups) 
as wanted or not wanted; this is done in 
co-operation with Phase IA. 
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Phase LD 


Phase LD scans the STATIC chain for any 
variables which have been declared INITIAL. 

When a scalar variable is found, the 
phase constructs two dictionary entries: 
one for the constant, and one for the 
converted constant. 

For arrays, the phase scans the initial 
value string, creating an initialization 
table in the dictionary. Replication 
factors are converted and inserted into the 
table; treatment of the constants is then 
as described for scalar variables. 

Phase oS converts the constants to their 
specified internal form. 


Phase LG 


Phase LG scans the text for DO loops. A 
stack is maintained with each entry 
containing a description of a DO group. 

The stacking reflects the nesting of the DO 
groups. For each DO or iterative DO triple 
a new entry is made at the top of the 
stack. 

DO specification triples are analyzed 
and expressions are assigned to 
temporaries; subscripts in the control 
variable are assigned to binary integer 
temporaries if they are themselves 
variable. At the end of each 
specification, pseudo-code and triples are 
generated to control the loop. 

Triple operators (see Appendix D.4 ) 
peculiar to the specification of DO loops 
are removed from the text. 

For control variables, other than simple 
scalars, text is placed in the DO stack and 
used at every appearance of the control 
variable in the generated text. During 
this time, a scan is also made for 
pseudo-variables, subscripts, functions, 
and argument markers. 


Phase LR 


The purpose of Phase LR is to save space 
during the expression evaluation phase, LS. 
It provides the initialization for Phase LS 
by obtaining 4,096 bytes of scratch storage 

I and setting stack pointers. The scan phase 
is initialized and Phase MP is marked. 


The translate table for scanning 
triples, and the constants for expression 
evaluation are included in this phase and 
are moved to the first IK area of scratch 
storage. Subroutines required by phase LS 
are also moved into scratch storacre at this 
time. Finally, control is passed to Phase 
LS. 


Phase LS 


Phase LS scans the source text to convert 
expression triples to pseudo-code. If a 
triple produces a result, it is added to 
the temporary work stack. 

For the arithmetic triples 
prefix +, and prefix -, the operands are 
combined to give the base, scale, mode, and 
precision of the result. If conversion is 
necessary, an assignment triple, with the 
target and source types as operands, is 
inserted in the text. In-line pseudo-code 
is generated for all operators except ** 
and some complex type * and / operators. 

In these cases, library calling sequences 
are generated. An intermediate result is 
always produced and the triple is removed 
from the text. 

The operands of comparison triples GT, 
GE, equals, NE, LE, and LT are combined and 
converted as for the arithmetic triples. 
In-line pseudo-code is generated and the 
triple is removed from the text, unless 
both operands are string type, in which 
case a temporary is created. If the next 
triple is a conditional branch, a mask for 
branch- on- false is inserted. Otherwise, 
the result is a length 1 bit string. 

For the string triples CAT, AND, OR, 

NOT, and string comparisons, if an operand 
is zero, TMPD triples, containing the 
intermediate result from the top of the 
stack, are inserted in the text after the 
triple. The result is a CHARACTER or BIT 
string or a compare operator. 

When subscript triples appear, a 
symbolic register number is inserted in the 
triple. The result contains the dictionary 
reference of the array and the symbolic 
register. 

For function triples, a description of 
the workspace for the function result is 
inserted in the TMPD triples which follow 
the function triples. The function result 
is added to the intermediate stack. 

For add, multiply, and divide functions, 
the function and argument triples are 
removed from the text. Arithmetic type 
in-line pseudo-code is generated, with 


62 



modifications for the precision and scale 
factor, and the result is added to the 
intermediate stack. 

With pseudo-variable triples, a special 
marker is added to the intermediate result 
stack. 

Other triples which may use an 
intermediate result, are examined. If an 
operand is zero, two or three TMPD triples, 
containing the intermediate result from the 
top of the stack, are inserted in the text 
after the triple. If both operands are 
zero, the TMPDs for the second operand 
precede those for the first operand. 


Phase LV 


Phase LV provides string handling 
facilities for the pseudo-code phases. 

It converts any type of data item to a 
CHARACTER or BIT string, and an assignment 
triple, with the target and source types 
used as the operands, is inserted in the 
text. 

A string dope vector description is 
produced from a standard string 
description. 


Phase LX (LW, LY) 


Phase LX consists of three modules, LW, LX, 
and LY. Module LW acts as a pre-processor 
for LX and LY, moving constants into 
scratch storage prior to loading the 
string-handling modules. 

Phase LX scans the source text to 
convert string triples to pseudo-code. If 
a result is produced it is added to a stack 
of intermediate string results. 

For the comparison triples GT, GE, 
equals, NE, LE, AND LT, both operands are 
already string type. If one operand is 
zero, the operand is obtained from the 
associated TMPD triples. In-line 
pseudo-code is generated if the operands 
are aligned and are of known lengths less 
than or equal to 255 bytes; otherwise, 
library calling sequences are generated. 

The triple and any TMPD triples are removed 
from the text. 

In the case of the string triples CAT, 
AND, OR, and NOT, the operands are 
converted to string type by phase LV. Zero 
operands are obtained from associated TMPD 
triples. In-line pseudo-code is generated 


when operands are aligned and are of known 
lengths less than or equal to 255 bytes. 

For the CAT operator, the first operand 
must be a multiple of 8 bits unless the 
strings involved are less than or equal to 
32 bits in length. In-line code is also 
generated for the following cases involving 
non-ad justable varying strings; 

1. Character string concatenation of 
varying strings with lengths less than 
256 bytes. 

2. Bit string operations for AND, OR, 

NOT, concatenation, and comparison 
where the strings are aligned and are 
less than 33 bits in length. 

Otherwise, library calling sequences are 
generated. The triple and any TMPD triples 
are removed from the text, and the string 
result is added to the intermediate result 
stack. 

For TMPD triples, if the intermediate 
result described by the TMPD triples is a 
string, a complete string description is 
moved from the top of the intermediate 
stack to the TMPD triples. If the TMPD 
triples do not describe a string, they are 
ignored. 

In-line code is generated for the BOOL 
functions AND, OR, and EXCLUSIVE OR, when 
the third argument is a character or bit 
string constant and the first and second 
arguments are aligned and of known lengths 
less than or equal to 255 bytes. Otherwise 
library calling sequences are generated. 
Subscript and function triples may produce 
intermediate string results. 


Phase MA 


Phase MA generates pseudo- code for both the 
in-line invocations of TRANSLATE and VERIFY 
and for the invocations which call a 
library routine. It is optional depending 
on the presence of the TRANSLATE or VERIFY 
function in the source program. 

Three kinds of tables are handled; 

1. Compile-time created (up to three) 

2. Floating, initialized by in-line code 

3. Floating, initialized by library 
subroutine 

When three constant tables have been 
created at compile-time, any further 
occurrence of this case, will cause the 
constants of both the second and third 
arguments to be handled via the library. 
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Blocks which have RECURSIVE, TASK, or 
REENTRANT attributes will have their own 
table, otherwise one table will be used for 
many blocks. 


normal function processor phase is loaded. 
When the end-of-program marker is 
encountered the terminating routine is 
entered. 


Phase MB 


Phase MB scans the text for pseudo- variable 
markers and multiple assignment markers. A 
stack of pseudo- variable descriptions is 
maintained, together with the left hand 
side descriptions of multiple assignments 
when they occur. Pseudo-code and triples 
are generated for pseudo-variables and the 
left hand side descriptions of multiple 
assignments are put out in the correct 
sequence. 


Phase MD 


Phase MD uses the SCAN routine to scan the 
text for ADDR and STRING built-in functions 
for which it generates in-line code. It 
appears before the normal function 
processor phase and removes all trace of 
the in-line function. The general SCAN 
routine passes control when these functions 
are found. 

For all cases of ADDR the generated code 
establishes the start address of the 
argument. If struct tare name arguments are 
present the structure chain is hashed for 
the first base-element. For array names 
the address of the first element is 
calculated. 

If the argument to the STRING function 
is contiguous in main storage, and its 
length is known at compile-time, an 
adjustable string assignment is generated. 
Otherwise the library routines IHESTGA and 
IHESTGB are called to produce the 
concatenated length and to concatenate the 
elements of the array or structure 
argument. 


Phase ME 


Phase ME identifies all invocations of the 
SUBSTR function and pseudo- variable, all 
UNSPEC, STATUS, and COMPLETION functions, 
and those invocations of the INDEX function 
which can be implemented in-line; and 
generates pseudo-code to perform these 
functions at object time. The scan of the 
text is conducted by the general SCAN 
routine, and all trace of the invocations 
of these functions is removed before the 


Phase MG 


Phase MG identifies functions which are to 
be coded in-line, and generates, in their 
place, the pseudo-code to perform the 
relevant function. This phase appears 
before the normal function processor phase 
and removes all trace of the in-line 
function. 


The scan of the text is conducted by the 
general SCAN routine, and control is handed 
to the present phase when one of the 
following functions is found; 


ALLOCATION FLOOR 
BIT IMAG 

CEIL REAL 

CHAR TRUNC 

COMPLEX 
CONJG 


BINARY 

DECIMAL 

FIXED 

FLOAT 

PRECISION 


Control is also passed to this phase if 
ABS is found with real arguments. The 
arguments are collected, and the 
appropriate routine is entered to generate 
the pseudo-code. When the end-of-program 
marker is encountered the terminating 
routines are entered. 


Phase MI 


Phase MI identifies functions which are to 
be coded in-line, and generates , in their 
place, pseudo- code to perform the relevant 
function. This phase appears before the 
normal function processor phase and removes 
all trace of the in-line function. 

The scan of the text is conducted by the 
general SCAN routine and control is handed 
to the present phase when one of the 
following functions is found: 

MAX MOD 
MIN ROUND 

If the number of arguments to the MAX or 
MIN functions is greater than three, a 
library call is generated. 
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Phase MK 


Phase MK identifies functions which are to 
be coded in-line, and generates, in their 
place, pseudo-code to perform the relevant 
function. This phase appears before the 
normal function processor phase and removes 
all trace of the in-line function. 

The scan of the text is conducted by the 
general SCAN routine, and control is passed 
to the present phase when one of the 
following functions is found: 

DIM HBOUND 

LBOUND SIGN 
LENGTH FREE 


Phase ML 


Phase ML scans the source text for generic 
entry name arguments to procedure 
invocations. 

Such entry names may be floating 
arithmetic built-in functions or 
programmer-supplied procedures with the 
GENERIC attribute. When one is found, the 
correct generic family member to be passed 
is selected by this phase, depending on the 
entry description of the invoked procedure. 


Phase MM 


Phase MM scans through the source text for 
procedure invocations by a CALL statement, 
or for procedure or library routine 
invocations by a function reference. 

Procedure invocations are replaced by an 
external standard calling sequence, and 
library routine invocations are replaced by 
an external or internal standard calling 
sequence as appropriate (see Appendix 
D.10). 

If a CALL is accompanied by a TASK, 
EVENT, or PRIORITY option, library module 
IHETSA is loaded rather than IHESA, and the 
parameter list is modified to include the 
addresses of the TASK and EVENT variables 
and the relative PRIORITY. 


Phase MP 


Phase MP reorders the BUY and SELL 
statements involved in obtaining Variable 
Data Areas (VDAs) for adjustable length 


strings or temporaries, which were created 
by Phase GK. On entering this phase, the 
BUY triples precede the code compiled to 
evaluate the length of storage required for 
the VDA. This evaluation code is included 
between further BUYS and BUY triples, which 
themselves are between the BUY triple being 
considered and its associated SELL triple. 
Phase MP extracts these sections of code 
and places them before the BUY triple of 
the adjustable string temporary. Since 
such BUY triples may be nested, the phase 
maintains a count to record the nesting 
status. 


Phase MS 


Phase MS scans the source text for 
references to subscripted array elements. 

If references are found, pseudo-code is 
generated to calculate the offset of the 
subscripted element in relation to the 
origin of the array. If necessary, further 
pseudo- code is generated to check the 
subscript range. 

Optimization of constant subscript 
evaluation is carried out on arrays having 
subscripts which are integer constants, and 
for which the corresponding dope vector 
multipliers are constant. This applies to 
arrays with fixed-length elements. 


Phase NA 


Phase NA generates pseudo- code for the 
following triples: 

For PROCEDURE* and BEGIN* triples a 
Library call is generated to the FREEDSA 
routine . 

For RETURN triples a library call is 
generated, unless a value is to be returned 
as the result of a function invocation, in 
which case code is first generated to 
assign the result to the target field, and 
then the library call is made. If the 
function may return the result as more than 
one data type, a switch would have been set 
at the entry point to the function, and the 
RETURN statement would test the switch 
value, so that the data type appropriate to 
the entry point is returned. 

GOTO triples either will be invalid 
branches detected by Phase FI, in which 
case they will be deleted, or they will be 
branches to statement label constants in 
the same PROCEDURE or BEGIN block. In this 
case, they will be compiled as 
one-instruction branches. 
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GOLN triples are compiled into 
one-instruction branches to the compiler 
label number in operand 2 of the triple. 

A GOOB (Go Out Of Block) triple is a 
branch to a label variable, possibly 
subscripted, or to a label in a higher 
block than the current one (a branch to a 
lower block is invalid). A call is 
generated to a library epiloaue routine, 
pointing at a double-word slot containing 
the address of the label and the 
Pseudo-Register Vector (PRV) offset (for a 
label constant) , or the invocation count 
(for a label variable). 

STOP and EXIT statements are implemented 
simply by invocation of the appropriate 
library routine. 

For IF triples, if the second operand is 
an identifier, or the result of an 
expression which is not a comparison, code 
is generated to convert it to a BIT string, 
if necessary. This BIT string is compared 
to zero, either in-line, or by a call to 
the library. 

The second operand may be a mask which 
will have been inserted by the expression 
evaluation phase as a result of the 
comparison specified in the IF statement. 
This mask is put into a generated 
instruction to branch if the condition is 
not satisfied, i.e., either to the ELSE 
clause or to the next statement. 

For ON triples, code is generated to set 
flag bits and update the ON-unit address in 
the double-word ON slot in the DSA. 

For SIGNAL arithmetic condition triples, 
in-line code is generated to simulate the 
condition. For all other conditions, a 
library error routine is called. 

REVERT triples generate code to set flag 
bits in- the double-word ON slot in the DSA. 


Phase NG 

Phase NG generates the calling sequences to 
the library for DELAY and DISPLAY and WAIT 
statements. 

It generates code to call the library 
routines which handle ALLOCATE and FREE 
statements whose arguments are BASED 
variables . 

For DELAY statements, the argument has 
to be a fixed binary integer, and, if 
necessary, code is generated for 
conversion. 


For DISPLAY statements, the message must 
be a CHARACTER string, or, it necessary, 
converted to one. A parameter list is 
built up to pass to the library. 


For WAIT statements, the parameter list 
is built up in workspace. It consists of 
the address of the scalar expression 
(converted to a fixed binary inteqer) , 
followed by the addresses ot the 
event-names that appear in each WAIT 
statement. If the scalar expression option 
does not appear, the address of the total 
number of event-names is used. 


For the tasking option WAIT, whose 
argument is an EVENT array, the phase makes 
a 4-byte entry in the parameter list, 
containing the number of dimensions 
involved, and the address of the EVENT 
array dope vector. If the WAIT statement 
contains an EVENT array and no scalar 
expression, the first byte of the parameter 
list is set to X'FF*. 


For ALLOCATE and FREE statements, with 
based variables as arguments, a parameter 
list is built in workspace before a call is 
made to one of the entry points to IHELSP. 
The parameter list is an 8-byte RDV 
followed by the address of the AREA 
variable from the IN option if present. 

For ALLOCATE, the pointer-variable in 
the SF.T option is given the value returned 
by IHELSP. 


Phase N J 

Phase NJ and its supporting block, NK, 
generate the calling sequences to the 
library module for the RECORD-oriented 
input/output statements: DELETE, LOCATE, 
READ, REWRITE, UNLOCK, and WRITE. 

For each of these calls, the information 
contained in the options of the source 
statement is passed by a parameter list, 
constructed as follows : 

DC A(DCLCB) 

DC A (RDV | COUNT 1 | PNTR a | SDV 3 ) | 0 

DC A (EVENT | LABEL 4 *) | 0 

DC A ( SDV. KEYTO | SDV. KEYFTROM | SDV. KEY) 10 

DC A ( REQUEST_CODES ) 

1 expr in IGNORE (expr) 

2 pntr in READ SET (pntr) 

3 SDV of varying string in READ INTO 

(varying string) 

4 Compiler label as result of LOCATE 
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REQUEST_CODES is a full-word containing 
four control bytes with the following 
meanings : 

Byte 0 Operation code 
00 READ 
04 WRITE 
08 REWRITE 
0C DELETE 
10 LOCATE 
14 UNLOCK 

Byte 1 Group 1 options code 
00 SET 
04 IGNORE 
08 INTO | FROM 

Byte 2 Group 2 options code 
04 KEYTO 
08 NOLOCK 

Byte 3 Group 3 options code 
04 VARY INTO 
08 VARY KEYTO 
0C BOTH 


Note that null arguments in the 
parameter list or REQUEST_CODES are 
indicated by zeros. 


Both the parameter list and the 
REQUEST_CODES word are constructed in 
STATIC storage. However, if the argument 
of any of the options refers to AUTOMATIC, 
CONTROLLED, or BASED storage, the parameter 
list is moved to the workspace storage for 
the statement; the argument is then 
provided just before the library call is 
made. 


In the case of the LOCATE statement, the 
phase is responsible for generating code to 
set the pointer variable with the pointer 
value returned in the first word of the RDV 
by the library. If the PASED variable was 
a structure with a REFER option in an 
extent definition, it is a iso responsible 
for generating code to initialize the 
extent variable named in the REFER option. 


The DCLCB parameter is taken from the 
FILE option of the statement; the FILE 
option rust be either a file constant or 
file parameter. 


The record dope vector (RDV) is assumed 
to have been constructed by earlier phases, 
except in the case of CONTROLLED or BASED 
variables or CONTROLLED or BASED 
aggregates, when the procedure is as 
follows; 


1. For CONTROLLED or BASED aggregates. 
Phase NJ creates a library call to 
IHESTRA , passing the following 
arguments through registers: 

Register 1 A(D.V) 

Register 2 A (DVD) 

Register 3 A (RESULT. RDV. SLOT) 


2. For CONTROLLED or BASED strings, the 
phase generates code to construct the 
RDV in the workspace storage of the 
statement, using the dope vector of 
the string. 


The IGNORE expression is taken from the 
IGNORE option of the statement and if 
necessary, converted to an integer. 


The EVENT scalar is taken from the EVENT 
option of the statement. 


The KEYTO SDV is derived from the KEYTO 
option of a READ statement. 


The KEY SDV and KEYFROM SDV are derived 
from their respective options. If 
necessary, they are converted to character 
strinas . 


The PNTR is taken from the SET triple of 
the statement or from the BASED variable of 
the LOCATE triple if no SET triple appears. 


Phase NM 


Phase NM generates the calling sequences to 
the. library modules for OPEN, CLOSE, GET, 
and PUT statements. 


For OPEN and CLOSE statements, a 
parameter list is constructed from the 
options given. The options are first 
checked for validity with respect to 
multiple specifications. The arguments on 
the options are checked and converted, if 
necessary, to the correct data type. If no 
file is specified in an OPEN or CLOSE 
statement, it is ignored. The parameter 
lists are as follows; 
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OPEN 

DC 

A(DCLCB) 


DC 

A(OCB) 


DC 

A ( TITLF . SDV) 


DC 

A(IDENT.SDV) 


DC 

A(IDENT.DED) 


DC 

A(KEYLENGTH) 


DC 

A(LINESIZE) 


DC 

A ( PAGESI ZE ) 

CLOSE 

DC 

A(DCLCB) 


DC 

A(IDENT.SDV) 


DC 

A(IDENT.DED) 


Null arguments are indicated by zero 
address constants. 

For GET and PUT statements, the library 
call is in three parts. The 
initialization, data transmission (Phase 
NU) , and the termination. The 
initialization call requires a parameter 
list to be constructed from the given 
options. The options are checked for legal 
combinations and the arguments examined. 

The parameter list when a file is 
specified is s 

DC A(DCLCB) 

DC A (next statement) 

DC A (binary integer) if SKIP or 
LINE is given. 

For GET and PUT STRING, the argument to 
STRING is checked, and the parameter list 
formed is: 

DC A (SDV of string argument) 

DC A(DED of string argument) 

The termination library call has no 
parameters. As for the initialization, the 
routine used depends on the options given 
in the statement. 


Phase NT 


This phase, which is a preprocessor for 
Phase NU, has two functions: 

1. Initialization of a block of scratch 
storage for use by Phase NU 


2. Setting up of INCLUDE matrix and 
library routine entries for 
edit- directed, STREAM-oriented I/O 
statements 

The phase contains all pseudo-code 
skeletons used by Phase NU. 4096 bytes of 
scratch storage are obtained and the 
pseudo-code skeletons are copied into it. 
The address of the scratch area is then 
passed to Phase NU. 

If a flag has been passed from Phase NM, 
indicating the presence of edit-directed 
I/O, a scan of the text is performed. Data 
and format list items encountered during 
the scan are associated as far as possible, 
and a sufficient set of library modules are 
identified for the edit-directed 
transmission specified in the prooram. The 
INCLUDE matrix is updated and dictionary 
entries are made for the required library 
format-director routines. 


Phase NU 


Data/format lists in I/O statements produce 
an internal library calling sequence (see 
Appendix D.10) for each data item and 
format item pair, using registers to point 
at the data item, the data item DED, and 
the FED for the format item. 

Iterations of data items, as in array 
input or output, and of format items, are 
achieved by making DO loops out of the 
iterations . 

The data items are transmitted serially, 
with program flow going from an item in the 
data list, to the corresponding format item 
and then to the relevant library I/O 
module. On return from the library module, 
control goes to the code for the next data 
item or, in the case of repeated data 
items, to another iteration of the DO loop. 

Remote format statements are executed in 
a similar way. After the R format item is 
met, control is passed directly from the 
data list to the format statement until the 
end of the format statement, control then 
returns to the item in the in-line format 
code of the EDIT statement following the 
appropriate remote format item. However, 
if no format elements remain but some data 
list elements are still present, control is 
passed back to the beginning of the format 
statement. 

An R format item referring to a label 
which is not attached to a format statement 
will cause an object time error condition 
to be raised, and the execution to 
terminate. 
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Phase OB 


Phase OB scans through the text for 
compiler functions and compiler 
pseudo-variables (see Appendix D.8). When 
a compiler function is found, pseudo-code 
is generated to access the operands of the 
compiler functions (e.g., string length, 
array bound) , and to place the operand in 
the location specified by the TMPD 
following the function. Assignments to 
compiler pseudo- variables are treated in 
reverse; the result from the TMPD following 
the assignment is stored in the array bound 
or string dope vector slot specified in the 
compiler pseudo- variable . 

Phase OB also scans the text for BUY, 
SELL, and BUY ASSIGN statements. The 
temporary operands of these statements are 
examined, and if they are CAD or short 
fixed-length strings, they are allocated 
the next available workspace offset, and 
the BUY and corresponding SELL statements 
are removed from the text. 


Phase OP 


This phase contains the translate and test 
table used by SCAN, and other tables and 
constants for phase OE. A block of scratch 
storage is obtained into which the tables, 
routines, and constants are moved. A 
pointer to the beginning of this area is 
passed to OE in a register. 


Phase OE 


Phase OE translates the following triples 
into pseudo-code: 

Assignment 

Multiple source assignment 

Multiple target assignment 

ALLOCATE, FREE, BUY, and SELL 

Special assignment 

In-line code is generated for the 
following types of ASSIGNMENT triples: 

1. Floating-point to floating-point 

2. Fixed binary to fixed binary 

3. Fixed decimal to fixed decimal 

4. Numeric field to numeric field, if the 


pictures given for the operands are 
identical 


5. CHARACTER string to CHARACTER string, 
if the operands are fixed length and 
not more than 256 characters 

6. BIT string to BIT string, if the 
operands are aligned and not more than 
2040 bits 

7. Label to label 

8. File constant to file parameter 

9. POINTER/OFFSET to POINTER/OFFSET 

10. FIXED CHARACTER string to VARYING 

CHARACTER String and VARYING CHARACTER 
string to VARYING CHARACTER string 
provided that: 

1. The length of the source operand 
is not greater than 256 bytes 

2. The length of the target string is 
not area ter than 256 bytes, if the 
maximum length of the source 
string is not known. 

3. For FIXED CHARACTER string to 
VARYING CHARACTER String the 
length of the FIXED string is not 
greater than 256 bytes. 

Library calling sequences are compiled 
for those cases of CHARACTER string to 
CHARACTER string and BIT string to BIT 
string codes not compiled in-line. 

After checking both AREA operands, AREA 
assignments are performed by the library. 

All other assignment triples are 
translated into the CONV pseudo-code macro. 

If the source operand is a constant, the 
type of the target operand is inserted in 
the constant dictionary entry, for 
processing by the constant conversion 
phase, and the assignment is translated 
assuming the target type. 

MULTIPLE ASSIGNMENT triples produce the 
same code as for single assignment, except 
that the registers used by the operand 
concerned must not be changed or dropped. 

Library calling sequences are generated 
for ALLOCATE. FREE. BUY, and SELL triples, 
and pseudo-code markers are left in the 
text for insertion of code by Phase QF. 

With SPECIAL ASSIGNMENT triples, if the 
target is a varying or adjustable string, 
storage is obtained if the target is 
AUTOMATIC, or allocated if the target is 
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CONTROLLED. The assignment is then 
translated. 


Phase OG (OL) 


Phase OG converts to pseudo- code all 
statement numbers, statement labels, 
PROCEDURE, BEGIN, PROCEDURE', BEGIN*, and 
end-of-program triples. 

The CONVERT pseudo- code macro is 
examined in conjunction with the 
OPTIMIZATION parameter and pseudo- code is 
generated in one of three forms: 

1. Code to call the library conversion 
package 

2. Code to perform the conversion 
"in-line" 

3. A modified CONV macro which is passed 
to phase OM or OP for processing. 
In-line conversion phases which are 
not required (OM and/or OP) are marked 
unwanted. 

IGN pseudo-code items and JMP triples 
are removed. The amount of temporary 
working space required by each block of 
program is calculated and placed in the 
workspace dictionary entry (see Appendix 
C.7) . 

The format of the text is converted so 
that a pseudo-code item does not span 
blocks. 

The INCLUDE card matrix is formed for 
all the conversion modules required. 


Phase OM 


Phase OM is called when either optimization 
levels 00 or 01 are specified. This phase 
scans the pseudo-code for the CNVC macros, 
which phase OG has placed into the text as 
28-byte entries containing a transfer 
vector to select the appropriate conversion 
routine within OM, and replaces any such 
macros with in-line code. 

The conversions inserted by phase OM are 
controlled by phase OG. When OPT=0, 
certain of the simpler FIXED DEC to 
PICTURE, PICTURE to FIXED DEC, and FIXED 
DEC to FIXED BIN conversions are passed to 
OM. When 0PT=1, the remainder of the 
feasible FIXED DEC to or from PICTURE and 
FIXED DEC to FIXED BIN conversions are 
passed to OM together with FIXED DEC to 
CHAR conversions. 


Certain FIXED DEC to PICTURE 
conversions, which phase OG cannot itself 
efficiently detect to be uneconomic when 
performed in-line, are recognized by phase 
OM, which inserts the calls to the 
appropriate library routines. 


Phase OP 


Phase OP generates in-line code to perform 
BINARY to BIT string, BIT string to BINARY, 
and FLOAT to FIXED BINARY conversions. 


Phase OS 


Phase OS scans through the constant chain 
in the dictionary and converts the 
constants to the required internal form. 
These are then stored in a constants pool, 
and the offset of each constant from the 
start of the pool is saved in the 
dictionary entry for that constant. 

To permit the correct alignment of the 
constant pool, three scans are made of the 
constant chain; first to convert all double 
word constants, secondly to convert all 
single word constants, and thirdly to 
convert all unaligned constants. 

In the first two scans only one pool 
entry is made for constants having the same 
internal form and value. 

A fourth scan is made of the constant 
chain and all constants required to 
initialize static are converted, but 
instead of inserting these constants in the 
constant pool, they are moved into special 
dictionary entries constructed by Phase LB. 


THE STORAGE ALLOCATION LOGICAL PHASE 


The purpose of the Storage Allocation Phase 
is to ensure that every item requiring 
storage in a PL/I object program obtains a 
unique location of the correct size, 
located on the correct boundary. Items 
requiring storage include PL/I source 
program variables, dope vectors, dope 
vector skeletons, temporary variables, work 
areas, data descriptors, symbol tables, 
addressing slots, register save areas, flag 
areas, etc. Storage locations are 
allocated to items in order of descending 
alignment requirement to avoid wasting 
storage by padding to the required 
alignment. 
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The Storage Allocation Phase is also 
responsible for generating prologues. In 
generating the prologues, expressions which 
determine size of variables, code generated 
by the aggregates phase to initialize dope 
vectors, and code generated by the initial 
values phase, must be extracted and placed 
in the correct sequence in the text. Also, 
when a variable depends for its size or 
initial value upon another variable, the 
requests for dynamic storage must be 
arranged so that the dependant variable 
obtains its storage after the variables 
upon which it depends. 

Since all AUTOMATIC and CONTROLLED 
storage is obtained dynamically at object 
time, the Storage Allocation Phase 
generates code to relocate dope vectors 
when the allocated storage address is 
known. 


Phase PA 


The purpose of phase PA is to determine the 
eligibility of the automatic chains of any 
block for STATIC DSAs. Any chain not so 
far found to be ineligible for a STATIC DSA 
is scanned to determine the DSA size. 

STATIC DSAs are generated for any chains of 
less than 512 bytes. 

Dictionary entries are generated for 
STATIC DSAs. This phase also acts as a 
spill area for routines used in phases PD 
and PH. 


Phase PD 


Phase PD is the first STATIC storage 
allocation phase. It scans the text, and 
for every second file statement encountered 
sets up a pointer in the associated 
dictionary which points to the second file 
statement. It then sorts the STATIC chain 
so that the dictionary entries occur in the 
order in which the storage for their items 
will be allocated. 

Storage is allocated for simple 
non-structured, non-external variables, 
RDVs, DEDs, SAVE/RESTORE entries, and the 
BCD of entry labels and label constants. 
Storage is also allocated for dope vectors 
for all items in the STATIC chain requiring 
them, with the exception of EXTERNAL items. 
A full word address slot is allocated in 
STATIC for each STATIC DSA. 

The external section of the sorted 
STATIC chain is scanned and a 4-byte 
addressing slot is allocated for each entry 


label, label constant, external (entry type 
4) entry, built-in function, or EXTERNAL 
item. For each EXTERNAL item the size of 
the external control section is calculated 
and stored in the dictionary entry. 


The constants chain is scanned and the 
offsets of the storage and dope vectors for 
constants in the constants pool are 
relocated. 

The current size of the STATIC INTERNAL 
control section is computed and the result 
is passed via the communications region to 
the next phase. 


Phase PH 


Phase PH is the second STATIC storage 
allocation phase. It scans the AUTOMATIC 
chain and CONTROLLED chain for all items 
requiring a dope vector. 

For each such item a skeleton dope 
vector dictionary entry is generated in the 
STATIC chain (see Appendix C.7). This 
dictionary entry contains a bit pattern 
equal in length to that of the dope vector 
and containing all those values which are 
known at compilation time. In particular, 
it contains as much of the relative virtual 
origin as is known at compilation time, the 
constant bounds and string lengths, and the 
constant multipliers. 

Skeleton dope vectors are not put into 
the STATIC chain for AUTOMATIC variables in 
any block whose DSA is in STATIC, except 
when the variable dimensions bit is set to 
one. 

If the item is dynamically DEFINED, then 
the dope vector is preceded by one extra 
four-byte slot. (In the case of structures 
there is one extra slot for each element of 
the structure. ) If the item is a dynamic 
temporary (temporary type 2) or a 
CONTROLLED scalar string, the virtual 
origin slot is relocated by the length of 
the dope vector. 

In all cases the skeleton dope vector 
dictionary entry is pointed at by the 
dictionary entry of the associated item. 

The sorted STATIC chain is scanned from 
the first skeleton argument list entry. 

For each such entry, space is allocated in 
the STATIC INTERNAL control section 
according to the assembled length of the 
argument list. The offset of each skeleton 
argument list is stored in the OFFSETl slot 
of the dictionary entry. 


Chapter 2: The Compiler Logical Phases 61 



RDV and DVD entries are found on this 
same scan of the STATIC chain. RDV entries 
are allocated eight bytes; DVD entries are 
allocated the specified length. 

A scan is made of the section of the 
STATIC chain containing STATIC INTERNAL 
arrays. Storage is allocated for each 
array according to its size (computed by 
Phase JK) and the offset of the relative 
virtual origin is relocated to the start of 
the STATIC INTERNAL control section. If 
the array is of the VARYING type and it 
needs a dope vector , then storage is 
allocated for the secondary dope vector. 

The number of elements is calculated for 
INITIAL arrays and stored in the associated 
INITIAL dictionary entry. 

The section of the STATIC chain 
containing STATIC INTERNAL structures is 
scanned. Storage is allocated for each 
structure according to the size of the 
structure (computed by Phase JK) , and this 
storage is placed on the correct boundary 
on information supplied by Phase JK. The 
structure member chain for each structure 
is scanned and the relative offset of each 
member is relocated to the start of the 
STATIC INTERNAL control section. Further, 
on the structure member scan, secondary 
dope vectors are allocated when required, 
and the number of elements is calculated 
for INITIAL arrays. 


Phase PL 


Phase PL scans the STATIC, AUTOMATIC, 
CONTROLLED, structure, and PROCEDURE block 
chains for variables which require storage 
for their symbol tables and/or data element 
descriptors. 

When a variable is found which requires 
a symbol table, the variable is joined onto 
the chain of symbol variables for the 
particular block. A symbol table 
dictionary entry is created for the 
variable (see Appendix C.7), and a chain is 
set up to and from the dictionary entry for 
the variable. The new dictionary entry is 
joined onto the STATIC chain. 

The size of the symbol table is 
calculated, and its offset from the start 
of the STATIC control section is stored in 
the symbol table dictionary entry. 
Throughout the allocation of STATIC storage 
a location counter is maintained to contain 
the next free location in STATIC; this 
counter is increased appropriately. 

All symbol variables require a DED and a 
branch is taken to the routine which 
allocates them. 


When a variable is found which requires 
a DED, it is determined whether or not the 
DED describes a standard type; there are 
eight standard types, which consist of the 
different kinds of real coded arithmetic 
data that can be obtained by the 
combination of the attributes FIXED/FLOAT, 
BINARY/DECIMAL, LONG/SHORT (default 
precisions only) . 

If the DED is of a standard type, a 
check is made for an identical DED that may 
have already been encountered, so that 
there will be only one allocation of 
storage for any one type of standard DED. 

If the DED is not of a standard type, it is 
allocated storage of its own. 

If the variable does not already have a 
symbol table dictionary entry (which 
contains space for DED information), a DED 
dictionary entry is constructed, and the 
offset of the DED in the STATIC control 
section is stored in it. A pointer in the 
new entry in the dictionary entry for the 
variable is also set up. 

When all data element descriptors and 
symbol tables in the compilation have been 
processed, all STATIC storage has been 
allocated and the total size of the STATIC 
control section is placed in a slot in the 
communications region. 


I Phase PP (PO) 


Phase PP extracts all ON condition entries 
and places them at the head of the 
AUTOMATIC chain. It then extracts all 
temporary variable dictionary entries from 
the AUTOMATIC chain and places them in the 
zone following the ON conditions in the 
chain. 

All dictionary entries which are totally 
independent of any other variable are 
extracted, and also placed in the zone 
following the ON conditions. 

The phase then extracts all dictionary 
entries which depend upon some other 
variable in containing blocks or in the 
zones already extracted, and places them in 
the next following zone. Dependency 
includes expressions for string lengths, 
expressions for array bounds, expressions 
for INITIAL iteration factors, and defined 
dependencies. This is repeated recursively 
until the end of the chain. If some 
variable depends upon itself, a warning 
message is issued. 

A special zone delimiter dictionary 
entry is inserted between each zone in the 
AUTOMATIC chain (see Appendix C.7). A code 
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byte is initialized in the delimiter to 
indicate to Phases PT and QF whether its 
following zone contains any variables which 
require storage (i.e., it does not consist 
entirely of DEFINED items, which do not 
require storage) , and whether or not the 
following zone contains any arrays of 
VARYING strings. 


Phase PT 


Phase PT allocates AUTOMATIC storage, scans 
the CONTROLLED chain, and determines the 
size of the largest dope vector. It scans 
the entry type 1 chain, and for each 
PROCEDURE block or BEGIN block it allocates 
storage for a DSA and compiles code to 
initialize the DSA. 

A two-word slot in the DSA is allocated 
for each ON condition in the block, and 
code is compiled to initialize the slot. 
Space for the addressing vector and 
workspace in the DSA is also allocated. 

Two words are allowed for tasking 
information in the DSA if the TASK option 
is on the external PROCEDURE of the 
compilation. 

The AUTOMATIC chain is scanned and dope 
vectors are allocated for the items 
requiring them. Code is compiled to copy 
the skeleton dope vector, and to relocate 
the address in the dope vector. 

Where there is a block with its DSA in 
STATIC, dope vector initialization is not 
performed for the variables in the first 
region of the AUTOMATIC chain. Address 
slots in dope vectors for variables in the 
remainder of the chain are relocated. 

Storage is allocated for addressing 
temporaries type 2 and for addressing 
controlled variables, and for the 
parameters chained to the entry type 1. 

The first region of the AUTOMATIC chain 
is scanned and storage allocated for double 
precision variables, single precision 
| variables, halfword binary variables, 
CHARACTER strings, and BIT strings, in that 
order. 

The first region of the AUTOMATIC chain 
is scanned and storage allocated for 
arrays, relocating the virtual origin. For 
arrays of strings with the VARYING 
attribute, the secondary dope vector is 
also allocated and code is compiled to 
initialize the secondary dope vector. 
Correctly aligned storage is allocated for 
structures. If a structure contains any 
arrays of strings with the VARYING 


attribute, the storage for the secondary 
dope vector is allocated at the end of the 
structure. 


A pointer is set up in the AUTOMATIC 
chain delimiter to the second file 
statement which has been created. 

The remaining regions of the AUTOMATIC 
chain are scanned and code is compiled to 
obtain a Variable Data Area (VDA) for each 
region. Code is compiled to copy the 
skeletons into the dope vectors and to 
relocate the addresses in the dope vectors. 
During this pass, any DEFINED items which 
are to be addressed directly have the 
storage offset and the storage class copied 
from the data item specified as the base 
identifier. 


Phase QF 


Phase QF, which constructs prologues, scans 
that text which is in pseudo-code form at 
this time with end-of-text block markers 
inserted. 

When a statement label pseudo-code item 
is found, it is analyzed and one of three 
things happens: 

1. The item is saved if it relates to a 
PROCEDURE statement 

2. The item is omitted if it relates to a 
BEGIN or ON block 

3. The item is passed if it relates to 
neither of the first two conditions 

When a BEGIN statement is found, a 
standard prologue of simple form is 
generated, and code is inserted from second 
file statements (if there are any) to get 
the DSA, either dynamically, or in the case 
of eligible bottom-level blocks, by using 
the supplementary LWS made available at 
initialization time. Code is also inserted 
to initialize the DSA and to allocate and 
initialize any VDAs. 

When a PROCEDURE statement is found, it 
is first determined whether it heads an ON 
block or a PROCEDURE block. If it is an ON 
block, a standard prologue (similar to that 
for a BEGIN block) is generated. If it is 
a PROCEDURE block, a specialized prologue 
is generated. This takes account of the 
manner of getting the DSA, the number of 
entry points, the number of entry labels on 
a given entry point, the number of 
parameters on each entry point, and whether 
the PROCEDURE is a function. 


Chapter 2: The Compiler Logical Phases 


63 



Prologue code is generated for AUTOMATIC 
sclalar TASK, EVENT or AREA variables, in 
order to perform the initialization 
required when these variables are 
allocated. 

The code generated by the prologue 
construction phase is partly in pseudo-code 
and partly in machine code. The machine 
code (which is delimited by special 
pseudo-code items) has the same form as the 
code produced by the Register Allocation 
Phase (see Appendix D.7). 

DSA optimization is performed under 
certain conditions (see Appendix H). 

At the end of the prologue, the 
statement label item saved earlier is 
inserted to mark the* apparent entry point. 
Code is produced to effect linkage to BEGIN 
blocks in such a way that general register 
15 contains the address of the entry point, 
and general register 14 contains the 
address of the byte beyond the BEGIN 
epilogue. 

At the end of the text, any text blocks 
that are not needed are freed, and control 
is passed to the next phase. 


Phase QJ 


Phase QJ scans the text for ALLOCATE, FREE, 
and EUY statements. 

On finding an, ALLOCATE statement, a 
routine is called which does a 'look ahead' 
for initialization statements associated 
with the allocated variable, e.g., 
adjustable array bounds or adjustable 
string lengths, and places the text 
references of each statement in the 
dictionary entry associated with each 
statement. 

If the allocated item has a dope vector, 
code is generated to move the skeleton dope 
vector generated by Phase PH into a block 
of workspace in the DSA of the current 
block . 

Any adjustable bound expressions or 
string length expressions are then 
extracted from the text references, and the 
expressions are placed in-line in the text. 

Any information required from previous 
allocations (specified by * in the ALLOCATE 
statement) is extracted from the previous 
allocation, and copied into the workspace. 

Code generated by Phase JK to initialize 
multipliers, etc., is extracted and placed 
in-line, after first loading the variable 


storage accumulator with the dope vector 
size. Phase JK generates code to increment 
the accumulator register by the size of the 
item. 


If the item has no adjustable 
parameters, code is generated to increment 
the accumulator by the size calculated at 
compilation time. If this size is greater 
than 4,096, Phase JK generates a constant 
dictionary entry, which is used in this 
code. 


If the item has any arrays of varying 
strings, the size of the array string dope 
vector is added to a second accumulator 
register. Code is generated to add the two 
accumulators into the second one, which is 
a parameter to a library routine. A 
routine is then called which extracts the 
library call inserted by pseudo-code and 
places it in-line in the text. 


Code is inserted after the library call 
to initialize the dope vector in workspace 
to point to the allocated storage. Code is 
generated to transfer the dope vector from 
the workspace to the allocated storage. 


The code generated by phase JK to 
initialize arrays of varying strings, 
tasks, events, and areas is then inserted 
in the output stream. 


Any initial value statements associated 
with the ALLOCATE statement are extracted 
and placed in-line. The initialization 
statements are then skipped, and the scan 
continues. The last two steps are also 
performed for LOCATE (based variable) and 
ALLOCATE (based variable) statements. 

Action for a BUY statement is similar to an 
ALLOCATE statement, with the following 
exceptions: 


1. Bound and string length code is 
in-line, bracketed between BUYS and 
BUY statements - there is therefore no 
look ahead 

2. There is no initial value code 
associated with temporaries 

3. A slot in the DSA is updated with the 
pointer to the allocated storage for a 
temporary 

The action on encountering a FREE 
statement is to generate code to load a 
parameter register with the pointer to the 
allocated storage for the FREE VDA Library 
call inserted by the pseudo-code. 
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Phase QU 


Phase QU scans the pseudo- code text in 
search of instructions which have 
misaligned operands. (A misaligned operand 
has the UNALIGNED attribute and is not 
aligned on the boundary appropriate to its 
data type). When such an instruction is 
found, QU inserts a move character (MVC) 
instruction in the pseudo-code text to move 
the operand to or from an aligned workspace 
area, and substitutes the address of this 
workspace for the operand address in the 
original instruction. If the address of a 
misaligned operand is loaded into a 
register, a note is made of that register. 
QU thereafter treats the instructions which 
refer to it as if they referred to the 
operand itself, by inserting a move 
character instruction, and substituting the 
workspace address for the reference in the 
instruction. 

In handling misaligned operands, phase 
QU uses storage beginning at offset 32 from 
register 9 for its workspace. 

Whenever a load address (LA) instruction 
is found which lies within the calling 
seguence of a library routine and which 
loads the address of a misaligned argument 
of that routine, an aligned workspace 
address is substituted in the instruction, 
and the requisite move character 
instruction is stacked. It is not inserted 
in the output text until the instruction is 
encountered that loads register 15 prior to 
the exit to the library routine, or in the 
case of EDIT-directed I/O routines, until 
the appropriate branch-and-link (BALR) 
instruction is encountered. The stacked 
move character instruction is inserted into 
the output before the exit to the routine 
if the argument in question is an input 
argument to the routine, and after the 
return from the routine if it is an output 
argument. 

Whenever a fixed binary temporary of 
precision <16 is encountered in the text, 
the dictionary is checked to see if this is 
a member of an argument list (phase GP will 
have set bit). If it is, the instructions 
referring to it are altered to halfword. 

The displacement in any Load Address 
referring to the temporary is incremented 
by 2. 

References to halfword binary items are 
replaced by halfword instructions where 
PL/1 permits. Where possible and 
desirable, fullword instructions are used 
to perform calculations, and only LH/STH 
instructions used to access storage. 

Fullword conversion is inserted into the 
library calls marked by phases LS and NG. 


In handling halfword binary items, phase 
QU uses 4 bytes, beginning at offset 0 from 
register 9, for workspace. * 


Phase QX 


Phase QX is the * AGGREGATE LENGTH TABLE ' 
printing phase. It is entered only if the 
ATR (attribute list) or XREF (cross 
reference list) options are specified. It 
scans the STATIC, AUTOMATIC, CONTROLLED and 
COBOL chains, and, for each major structure 
or non- structured array that is found, an 
entry is printed in the AGGREGATE length 
table. 


An AGGREGATE LENGTH TABLE entry consists 
of the source program DECLARE statement 
number, the identifier and the length (in 
bytes) of the aggregate. In the case of a 
CONTROLLED non- BASED aggregate no entry is 
printed for the DECLARE statement, but an 
entry is printed for each ALLOCATE for the 
aggregate, the source program ALLOCATE 
statement number being printed in the 
'statement number* column. 

Where the length of an aggregate is not 
known at compilation the word "ADJUSTABLE" 
is printed in the 'length in bytes' column 
of the entry for that aggregate. If an 
aggregate is dynamically defined, the word 
"DEFINED" appears in that column. An entry 
for a COBOL mapped structure (i.e. , a 
structure which a COBOL record is read into 
or written from) , has the word * (COBOL) " 
appended, but such an entry will appear 
only if the structure does not consist 
entirely of one of the following: 

• doubleword data 

• fullword data 

• halfword binary data 

• character string data 

• aligned bit string data 

• a mixture of character string and 
aligned bit string data 

If a COBOL entry does appear, it is 
additional to the entry for the PL/I mapped 
version of the structure. 

Before printing begins the aggregate 
length table entries are sorted so that the 
identifiers appear in collating sequence 
order. 
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THE REGISTER ALLOCATION LOGICAL PHASE 


The purpose of the Register Allocation 
Phase is to insert into the text the 
appropriate addressing mechanisms for all 
types of storage, and to allocate physical 
general registers where symbolic registers 
are specified or required as base 
registers. 

This phase comprises two physical 
phases, each with a specific function. The 
first. Phase RA, processes the addressing 
mechanisms, while the second phase. Phase 
ftp, allocates the physical registers. 

An additional phase RD is called in 
between RA and RF when the optimization 
option is 2 or greater. This phase 
attempts to optimize the storing and 
loading of registers in use over compiler 
generated branches. 


| Phase RA (RB,RC) 


Phase RA scans the text for dictionary 
references, the beginninos and ends of 
PROCEDURE and BEGIN blocks, and the 
starting points of the original PL/I 
statements. 

A dictionary reference, when found, is 
decoded into a word-aligned dictionary 
address and a code. These are used to 
determine what is being referenced. The 
corresponding object time address as an 
offset and base is then calculated. 

If the address required has an offset 
less than 4,096 and a base which is either 
an AUTOMATIC or STATIC data pointer, no 
extra instructions are generated. If this 
is not so, extra instructions are inserted 
in the text stream to calculate the 
required address. The calculation of this 
address is broken down into logical steps 
in a "step table.' On completion, the table 
is scanned backwards to determine whether 
an intermediate result has been previously 
calculated. The steps which have not been 
previously calculated are then assembled 
into the pseudo-code. 

The compiled code is added either to the 
output stream or to a separate file. The 
code in the separate file is terminated by 
a store instruction to save the calculated 
address. The extra "insertion file" is 
placed in the prologue of the relevant 
block by the next phase. Instructions are 
stored in-line if the referenced item is 
CONTROLLED, if it is a parameter, if fewer 
instructions are required to recalculate 
the base rather than load the stored 


address, or if the reference itself is in 
the prologue. 


If no addressing code is generated, a 
special item is put in text to tell phase 
RF what base to use. 


All relevant information for PROCEDURE 
and BEGIN blocks is stacked and unstacked 
at the start and end of the blocks 
respectively. 


At the start of PL/I statements, code is 
compiled to keep the required PREFIX ON 
slots in the Dynamic Storage Area updated. 
On meeting the pseudo-code error marker, 
the calling sequence to the library error 
package is generated, and the error marker 
removed . 


If the STMT option has been specified, 
code is generated at the start of each PL/I 
statement to keep the statement number slot 
in the current DSA up to date. 


Phase RD 


Phase RD examines all EQUs and determines 
their uses. A table is set up in scratch 
text blocks containing a four-byte slot for 
each EQU. The number of text blocks 
required is calculated from the value in 
the ZMAXEQ field in the • communications 
region. The first text block, containing 
the slots for the first N-4 EQU values 
(where N = text block size) , is locked into 
main storage so that these slots can be 
accessed by direct addressing. 

The other slots are accessed via their 
text references, and their text blocks are 
brought into storage as needed, by the 
compiler control routines. A dictionary of 
text block numbers for, each range of EQU 
values is kept in the phase. This allows 
for a maximum of 64 text blocks, i.e., 
under the smallest SIZE parameter a maximum 
of 16K EQU values are allowed. 

The table is built up during a pass of 
the program text. At the end of the text 
pass the table is scanned. Any EQU which 
is not used is deleted. Any EQU which is 
either before the first use or used more 
than once is flagged by setting the first 
bit of the EQU value on. During this scan 
of the table, the current table text block 
is locked into storage and released when 
the scan is completed for the block. 
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Phase RF (RG.RH) 


Phase RF scans the text for register 
occurrences, implicit and explicit, and the 
start and end of PROCEDURE and BEGIN 
blocks. At the beginning of PROCEDURE and 
BEGIN blocks all relevant information is 
stacked, and is later unstacked at the 
corresponding end. 

Registers are classified as assigned, 
symbolic, or base. 

Assigned registers require the 
explicitly mentioned register to be used. 

If that register is not free it is stored. 
Symbolic registers may occupy any register 
in the range 1 through 8. An even-odd pair 
may be requested. Base registers may 
occupy any of registers 1 through 8. 

When a register is requested, a table of 
the contents of registers is scanned, to 
determine whether the register already has 
the required value. If it does, that is 
used. If it does not, and it is not an 
assigned register, a search is made for a 
free register and this is allocated if one 
is found. Should no register be free, a 
look-ahead is performed to determine which 
register it is most profitable to free. 

If a register contains a base it need 
not be stored on freeing. If a register 
contains a symbolic or assigned register, 
it may require to be stored when freed, 
depending upon whether it has had its value 
altered since any storage associated with 
it was last referenced. 

At a BALR (Branch and Link) instruction 
it is ensured that all the necessary 
parameter registers are in physical 
registers, and not in storage. 

No flow trace is carried out by the 
compiler. Therefore, the register status 
is made zero at branch- in and branch-out 
points. An exception is at a conditional 
branch. Here the registers are not freed 
after having been saved. 

Any coded addressing instructions are 
expanded when found in-line. At a specific 
"insertion point" in a prologue, any 
addressing instructions in the "insertion 
file" are brought in and expanded. 


THE FINAL ASSEMBLY LOGICAL PHASE 


The Final Assembly Phase converts the 
pseudo-code output of the register 
allocation phase into machine code, the 
principal functions being the substitution 


of machine operation codes for pseudo- code 
operations, and the replacement of PL/I and 
compiler inserted symbolic labels by offset 
values. 

Loader text is generated for program 
instructions, DECLARE control blocks, and 
OPEN file control blocks, initial values 
defined in the source program, parameter 
lists, skeleton dope vectors, symbol 
tables, etc. ESD and RLD cards are 
generated for external names and 
pseudo-registers. An object listing of the 
code generated by the compiler is produced 
if the option has been specified by the 
source programmer. 


Phase TF 


Phase TF scans the text, assigns offsets to 
compiler and statement labels, and 
determines the code required for 
instructions which reference labels. 

The size of each procedure is determined 
and stored in the PROCEDURE entry type 1. 

A location counter of machine instructions 
is also maintained. 


Phase TJ 


Phase TJ scans the text until no further 
optimization can be achieved in the final 
assembly. 

A location counter is maintained for 
assembled code, and offsets are assigned to 
labels. 

The size of each procedure is determined 
and stored in the PROCEDURE entry type 1. 
The amount of code required for 
instructions to reference labels is also 
determined, while attempting to reduce this 
from the amount estimated by the first 
assembly pass. 

This phase also attempts to reduce the 
number of Move (MVC) instructions by 
searching for consecutive MVC instructions 
which refer to contiguous locations. 


Phase TO (TQ) 


Phase TO sets the four byte slot ZPRNAM, in 
the communication region, to contain the 
first four characters of the first entry 
label of the external, procedure, for the 
purpose of object deck serialization. 
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Phase TT 


Phase TO also produces ESD cards for the 
compiled program. It first makes up six 
standard entries for: 


1. Program Control Section (CSECT) <SD 
type) allowing room for the compiler 
subroutines if these are present. 


2. STATIC internal CSECT (SD type) 


3. Invocation count (PR type) 


4. Entry points to library routines, 
IHESADA and IHESADB (ER type) 


5. IHEQERR (PR) 


6. IHEQTIC (PR) 

If the external procedure has the MAIN 
option, an entry for a one-word CSECT (SD 
type) is made up. An entry is made for the 
CSECT 1H entry and entries are made up for 
all entry labels in the external procedure 
(LD type) . 

The entry type 1 chain is scanned and an 
entry (PR type) is made up for each block 
and procedure. 

The external section of the STATIC chain 
is scanned and entries are made up for: 

1. Built-in functions and library 
functions (ER type) 

2. Files (ER type) 

3. STATIC external variables (SD type) 

4. External entry names (ER type) 

5. Programmer ON condition names (SD 
type) 

The CONTROLLED chain is scanned and an 
entry is made up for each CONTROLLED 
variable and task name (PR type). 

The size of the program control section 
is incremented to include the compiler 
subroutines. 

All STATIC DSAs are put into the STATIC 
INTERNAL control section, their combined 
sizes being allowed for when the size of 
the CSECT is calculated. 

Module TQ is used to produce a list of 
library conversion routines required for 
execution of the program. ER type entries 
are made up for each name in the list. 


Phase TT scans the text and maintains a 
location counter for assembled code. 

Loader text (TXT) and relocation 
directory (RLD) cards for requested 
combinations of load and punch files are 
generated. 

Nested procedures are unnested at object 
time by suitable manipulation of the 
location counter. The offset of each 
procedure from the start of text is left in 
the PROCEDURE entry type 1. 

Compiler labels are numbered for use by 
the object listing phase, and trace 
information is set up at entry points. 

Phase TT also generates the text for the 
compiler subroutines. These subroutines 
are put out in one of the following 
combinations : 

1. EPILOGUE subroutine 
DYNAMIC PROLOGUE subroutine 
STATIC PROLOGUE subroutine 

2. EPILOGUE subroutine 
DYNAMIC PROLOGUE subroutine 

3. EPILOGUE subroutine 
STATIC PROLOGUE subroutine 


Phase UA 


Phase UA generates text for the static 
internal CSECT; initializes a CSECT for 
each static external variable; and, 
optionally (if the LIST option is present), 
lists all the text produced for the static 
internal CSECT and provides suitable 
comments. 

The phase first scans to the start of 
the external section of the STATIC chain, 
generating text for entry labels, label 
constants, compiler labels, file 
attributes, label variable BCDs, and DEDs 
for temporaries. Simple variables found on 
this scan are used, together with the 
labels, to mark the start of the character 
string section of the chain. 

The phase then scans to the end of the 
external section of the chain, initializing 
address constants for external variables, 
external entry names, built-in and library 
functions, programmer-defined ON-condition 
names, external files, and label constants. 
Text is made up for the constants pool. 

The third scan of the STATIC chain 
starts at the point left by the previous 
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scan, and generates text for dope vector 
skeletons, argument lists, RDVs and DVDs, 
and symbol tables. The scan is terminated 
at the end of the chain. 

Phase UA makes up RLD cards for the 
address slots for STATIC DSA's and for the 
address slot of the start of the epilogue 
subroutine, if generated. 

Text cards are output to initialize all 
AREA'S, EVENT'S, and TASK'S. Arrays of 
AREA'S, will have a text card for each 
element. 


Phase OP 


Phase UD generates RLD and TXT cards to set 
up dope vectors at link- edit and load time. 

TXT cards are generated for each STATIC 
DSA, containing its length, which is found 
in the STATIC DSA entry. 

TXT and RLD cards are generated to set 
up the dope vectors for structured items 
and any non-structured items appearing in 
the AUTOMATIC chains. The TXT cards are 
derived from the skeleton dope vector 
entries. The RLD cards are generated for 
each virtual origin slot. 

When the last STATIC DSA has been 
processed control is released from phase 
UD. 


Phase UE 


Phase UE initializes those items on the 
STATIC chain not processed by Phase UA. 

The phase first scans to the start of 
the external section of the chain, making 
up text for simple data, and listing label 
variables. 

The second scan starts at the head of 
the character string section of the chain, 
and initializes dope vectors for all static 
internal variables which need them. 

The third scan corresponds in extent to 
the third scan in Phase UA, but generates 
text for arrays, and simple and interleaved 
structures. At the end of this scan, a < 
test is made to determine whether the 
external procedure of the program has the 
MAIN option. If so, a one-word CSECT 
(IHEMAIN) is made up, to contain the 
address of the principal entry point to the 
compilation. 


The phase then executes its final scan, 
which extends over the external section of 
the chain, to initialize a CSECT for each 
external variable or external file. 

Finally, any incomplete text and RLD 
cards are punched out, and an END card is 
produced for the compiled program. If the 
OBJNM parameter is present for batch 
compilation, phase UD punches a NAME card 
to follow the END card. 


Phase PF (PH) 


Phase UF scans the text, and lists, in 
assembly language format, machine 
instructions compiled for the source 
program. It inserts comments in the 
listing for statement numbers, statement 
labels, entry points, prologues, and 
procedure bases. 

Phase UF contains module UH which 
generates NAME from a dictionary reference. 
UF also lists the text for the compiler 
subroutine. This is done by releasing UH 
and loading module UI which performs this 
function. Upon termination of this phase 
module Ui passes control to phase XA. 


THE ERROR EDITOR LOGICAL PHASE 


The Error Editor Phase is entered at the 
end of all compilations. The first phase. 
Phase XA, examines the dictionary and 
determines whether thfere are any messages 
to be printed out. If there are none, this 
phase terminates the compilation. If there 
are diagnostic messages to be printed put, 
phase XB is loaded and the third section of 
the phase directory is completed. Phase XC 
is then loaded and this together with phase 
XA causes further modules (XF, and blocks 
XG to YY) to be loaded* which process the 
error dictionary entries and print out the 
appropriate messages. 


Phase XA 


Phase XA examines the heads of the error 
chains in the first dictionary block, and 
the programmer options which specify the 
severity level of messages required. If 
there are no diagnostic messages to be 
printed, this phase prints out a completion 
message and completes the compilation. If 
diagnostic messages are required, the phase 
loads module XB which completes the phase 
directory for Compiler Control. Phase XB 


Chapter 2s The Compiler Logical Phases 69 



is then released and phase XC and the 
message address block XF are loaded. 

The error editor then scans down the 
error message chains and marks each error 
dictionary entry with an indication of 
where the associated message is to be 
found. This information is obtained from a 
table in module XF. 

The text of all error messages is kept 
in modules XG through YY . The messages are 
ordered, by severity, within these modules. 
Module XA will have listed those modules 
which contain messages required for a 
particular compilation. Module XC loads 
and releases these modules, one at a time, 
and extracts the required messages. Having 
loaded a particular module, the phase scans 
down the associated error message chain in 
the dictionary for error entries associated 


with the module. It accesses the error 
message text and scans it. 

The message to be printed is built up in 
a print buffer in internal compiler code. 
This involves a translation from EBCDIC 
mode, which is used for the message text 
skeleton. The message is completed by the 
insertion of a statement number, an 
identifier, or a numeric value as specified 
by the message dictionary entry. The 
message is segmented, where necessary, to 
avoid spilling over a print line, 
translated to external code, and finally 
printed out. 

When all error message dictionary 
entries have been processed, module XB 
returns control to phase XA, which passes 
control to module AA for termination of the 
compilation. 
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CHAPTER 3: FLOWCHARTS. TABLES. AND ROUTINE DIRECTORIES 


Mote; For descriptions of terms and 
abbreviations used in the text during a 
compilation which are mentioned in this 
chapter, refer to Appendix D.ll. 

This chapter provides a complete guide 
to the compiler logic, in the form of 
flowcharts and associated tables and 
routine directories, arranged in phase 
order. 


Flowcharts 

The flowcharts are presented at three 
levels of detail — overall, logical phase, 
and physical phase. The overall compiler 
flowchart (Chart 00) points to the logical 
{ phase flowcharts (Charts 01 through 11), 
each of which appears at the head of the 
set of physical phase flowcharts to which 
it points. The physical phase flowcharts 
point (by means of identifiers placed next 
to the blocks) to the various routines 
used. Entry points to physical phases are 
labeled. 

Where transfer is effected between 
modules within a physical phase, the entry 
label into the entered module is shown as 
follows: 

1. Where the means of transfer is a 
transfer vector, an asterisk is shown 
as the label on the flowchart, and a 
note at the foot of the chart states 
that the transfer vector table is 
located at the start of the module. 

2. When transfer is made from a decision 
block, the block representing the entry 
is labeled. 

With the exception of "fall-through" 
branches, all branches from decision blocks 
are labeled where possible. Where the 
branch is actually a branch table, this 
fact is indicated on the chart, and the 
label of the branch table is given. 


In some cases, additional labels have 
been given, to assist in following the 
program flow. 


Tables and Routine Directories 


For each physical phase, a table is 
provided, which lists the operations 
performed and identifies the routines and 
subroutines involved. Where applicable, a 
routine directory follows the table. This 
provides an alphanumerically arranged list 
of the routines and subroutines contained 
in the phase, and states their function. 

In some cases, a physical phase 
comprises more than one module; this means 
that routines contained in different 
modules may be listed together in one 
routine directory. To assist in 
cross-reference to the compiler listings, 
the following convention has been adopted: 
if a routine is contained in a module whose 
label is not identical to that of the phase 
under discussion, the label of the 
containing module is inserted in 
parentheses after the routine name in the 
directory . 

In the case of a phase sharing a routine 
contained in another phase, the label of 
the containing module is indicated in 
parentheses after the routine name in the 
"Subroutines Used" column. The routine 
will not then appear in the routine 
directory for the phase under discussion, 
but will be found in the routine directory 
for the containing phase. 


Chart and Table Identification 

Identification of tables and physical 
phase flowcharts is based on the phase 
label. 
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• Chart 00. Overall Compiler Flowchart 


♦♦♦♦Al ♦***♦*♦*♦ 

► * 

► fcNTRY « 

► 4 
*************** 


>♦ COMPILER * 
* CONTROL ♦ 
♦INITIALIZATION ♦ 

****** 4 4 4 4 ******* 


***«*£! ********** 
* 01 * 

*-*-*.*.*.*.*.*-* 

♦ COMPILE-TIME 
♦PRE-PROCESSOR 

♦ v 
***************** 


*<- 


wvu\oi,c,o rnnn& tvc. cui. VE.O azncUi.lv, 

TEXT AND DICTIONARY REFERENCES AND CONTROLS 
ALL INTERFACES BETWEEN THE COMPILER AND 
THE OPERATING SYSTEM. 


THE COMPILE-TIME PRE-PROCESSOR ACCEPTS INPUT CONTAINING 
THE COMPILE TIME STATEMENTS OF ?L/I AND 
PRESENTS THE COMPILER WITH THE SOURCE TEXT 
RESULTING FROM EXECUTION OF THESE STATEMENTS. 


****D1********* 

♦ * 

♦ RETURN ♦ 

♦ * 
*************** 


♦**♦♦02*** **♦♦**♦ 
♦ * 

* EXECUTE FORTY ♦ 
♦EIGHT CHARACTER* 
* PRE-PROCESSOR * 

♦ * 
***************** 


THE FORTY EIGHT CHARACTER SET PREPROCESSOR 
ACCEPTS SOURCE PROGRAMS WRITTEN IN THE FORTY 
EIGHT CHARACTER SYNTAX OF PL/I ANL CONVERTS THEM 
INTO SIXTY CHARACTER SYNTAX. 


ini. auuKur. rKuojwi* kcruvao ourtnr buuuo 
CHARACTERS AND LEAVES CERTAIN CHAINS IN THE 
PROCESSED TEXT TO AID LATER PHASES. 


***************** 


*-*-*_*_*_*_*_*_* 
♦ * 

* DICTIONARY * 

* * 
***************** 


THE DICTIONARY LOGICAL PHASE CONSTRUCTS THE 
DICTIONARY OF IDENTIFIERS FROM INFORMATION IN 
DECLARE STATEMENTS AND FROM CONTEXT, IT ALSO 
REPLACES BCD IDENTIFIERS IN THE TEXT BY REFERENCES 
TO THE DICTIONARY. 


***G1 *********** 
PRINT OUT 
♦ATTRIBUTE AND ♦ 
CROSS REFERENCE <- 
* TABLE * 

**************** 


***** 112 * ********* 

* 04 * 
*-*_*_*_*_*_*-*_* 

* * 
♦PRE-TRANSLATOR * 
* * 
***************** 


♦ TRANSLATOR * 

* * 
***************** 


♦****K1* ********* 


*_*_*_*_*_ 


* OPTIMIZATION ♦ 

♦ * 
***************** 


*< * 


AGGREGATES 


TEAT* KcAnKArtuinu 1/U LK&ATIWi Ibn 

VARIABLES WHERE PARAMETERS DO NOT MATCH THEIR 
CORRESPONDING ARGUMENTS. CONVERTING ARRAY AND 
STRUCTURE ASSIGNMENTS TO DO LOOPS, AND REMOVING 
ISUB EXPRESSIONS. 


THE TRANSLATOR LOGICAL PHASE CONVERTS THE 
PL/I SOURCE TEXT TO A COMPUTER-ORIENTED FORM 
CALLED 'TRIPLES*. GENERIC SELECTION IS ALSO 
CARRIED OUT. 


THE AGGREGATES LOGICAL PHASE MAPS ALL 
STRUCTURES AND ARRAYS TO ALIGN ELEMENTS 
ON CORRECT STORAGE BOUNDARIES. PSEUDO-CODE 
IS PRODUCED TO CARRY OUT INITIALIZATION AT 
OBJECT TIME. 
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Chart 00. Overall Compiler Flowchart (cont'd) 


♦***A1*** ****** 

l i 

* OOA2 < 


. *. 

B1 *. 

. * *. 

NO .* ♦. 

*. ATR OPTION . *<- 

*. .* 

*. . * 

*. , * 

* YES 


•••Cl*** ******** 

* PRINT OUT • 
AGGREGATE 
LENGTH TABLE * 


***«*A2 ********** 
♦ 08* 

->* PSEUDO-CODE * 
* LOGICAL PHASE * 


•****B2 ********** 

* 09* 
•-*-•-*-•-•-*-•-• 

-* STORAGE * 

* ALLOCATION * 

* LOGICAL PHASE * 
••••••**••••••*** 


THE PSEUDO-CODE LOGICAL PHASE PERFORMS MANY 
PASSES OVER THE TEXT. EACH PASS CONVERTS SOME 
OF THE TEXT CONTEXT TO A FORM ALLIED TO 
ASSEMBLY LANGUAGE, CALLED PSEUDO-CODE. 


THE STORAGE ALLOCATION LOGICAL PHASE SCANS THE 
DICTIONARY AND ALLOCATES OBJECT TIME STORAGE FOR 
ALL IDENTIFIERS. TEMPORARIES AND ADMINISTRATIVE 
REGIONS. PROLOGUES ARE CONSTRUCTED. 


THE REGISTER ALLOCATION LOGICAL PHASE PERFORMS AN 
ANALYSIS OF OBJECT TIME ADDRESSIBIUTY AND ALLOCATES 
PHYSICAL REGISTERS IN PLACE OF SYMBOLIC ONES. 



***** 01 *** ******* 

* 10 * 
*-*-*-*-*-♦-*-♦-* 

* REGISTER *- 

* ALLOCATION ♦ 

* LOGICAL PHASE * 
**••*•••••••*•••* 


***•* 02 ***•*•*•». 
* 11 * 
*- *- *- *- •- *- *- •- * 
->*FINAL ASSEMBLY * 
* LOGICAL PHASE * 


THE FINAL ASSEMBLY LOGICAL PHASE ESTABLISHES 
OBJECT TIME BRANCH ADDRESSES AND COMPLETES 
TRANSLATION TO MACHINE CODE. LOADER TEXT IS 
PRODUCED . 


$ 

.*. 

E2 *. 

.♦ ♦. 

NO .* IS LIST *. 
*. OPTION ON .♦ 


*. 


. • 


•**F2** ********* 


* PRODUCE 
OBJECT LISTING 


**************** 




. *. 

G2 *. 

.* *. 

NO .* ANY ♦. 

*. DIAGNOSTICS . < 

*. .* 

*. .* 

♦ . .* 

YES 


***H2*********** 

► PRINT OUT ♦ 
DIAGNOSTIC 
MESSAGES * 



V 

. * . 

J2 *. 

.♦ ANY ♦. 

.* MORE *. YES 
♦.COMPILATIONS .*- 
*. IN THIS .* 
•.BATCH.* 

* . . * 

* NO 


1 


***** 
*00 ♦ 
* A2* 


****K2********* 

* RETURN TO ♦ 
♦CALLING PROGRAM* 
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•Chart AA. Resident Control Phase Logic Diagram (Modules AA through AM, and jz) 


• LOAD * 

-^•INITIALIZATION *- 

* PHASE IEMAB « 


OPNFILES 

•••*«A3********** 

• OPEN SYSIN, • 


osisiru. OISUTJ * - 

•GET STORAGE ETC* 


* BUILD FIRST • 
->* HALF OF PHASE »- 

* DIRECTORY * 


•LOAD IEMAF AND • 
->*PROCESS OPTIONS* 
• LIST • 


•n 


♦ RELEASE IEMAF * 


YES .♦ EXTENDED *. NO 

*. DICTIONARY .* 

] *. REQUIRED .* 


********** 


->* LOAD IEMAN 


♦ ♦♦* 

* 

* B4 

* 

**** 

.* 




#*•* 

♦ 

♦ E2 


♦ E2 • <-, 

• * I 

*•*• I 




**** 

► * 

¥ 03 * 
► * 

♦ ♦♦♦ 


*. .* 

A 

1 * * 

<-♦ B2 * 
♦ * 

NO**** 

C2 *♦. 


.♦ IF THIS A ♦. YES 

. BATCH JOB •* 

*. -* 


• * IS SAME ♦. YES 
->*.TYPE OF DICT- •* — 
•-REQUIRED .* 


**** 

¥ * 
* B2 • 
» • 
**♦* 


1 


* C3 * — , 

•••••• l 


* LOAD IEMAL 


• OPEN SYSPUNCH • 


• »»* 

• » 

* D1 • 
» » 

*••* 


r — >• LOAD IENAC 


♦*** 

• • 

• E2 • 

• * 
**•* 


***E2 ••••*•••*** 

•PRINT LIST OF • 


****.£3 ********** 

* * 

• RELEASE * 
-^INITIALIZATION ♦- 

• PHASE IEHAB • 


LOAD I EM AH TO 
MARK LATER 
PHASES 


•*** 

• • 

• FI *~ 

• • 

• ••• 

Fl' ♦. 


. * 


*. 


*. 


.* HAS PHASE *. YES 

IEMBX . • 

, • 

.* 

*. . * 

* NO 


.♦ *. YES 

• .WAS IT I1MCV . • 

• . .♦ 


*»**»F2**** **•**• 
• • 

• EXECUTE IEMAC * 
>*T0 OPEN SYSUT3 • 

• FOR INPUT • 


»****G2 *»♦**♦»*** 

* • 

* EXECUTE IEMAG • 
->• TO TIDY UP *- 

* AFTER READ-IN * 


NOTE: 

IENXX IS ANY ONE 
OF THE PHYSICAL 
PHASES DESCRIBED 
IN THE FOLLOWING 
CHARTS 


S* *»»**•*»• 
**** •IEMXX • 

* Fl •< *CALL A COMPILER* 

• • * PHASE • 

**»» • • 


***«*Glt*t*«****** 


->* RELEASE IEMAC * 


.* *. YES 

♦.HAS IT IEMF1 .* 

• . .♦ 


.*. 

J1 •. 

.•END OF *. 

.•FIRST HALF ♦. YES 

♦ . PHASE LIST .* 

*. .* 


•****H2 ******* **• 

• EXECUTE IEMF1 * 

♦ TO SBE IF 
->* SYNTAX CHECK 

♦SHOULD TERMIN- * 
♦ATE COMPILATION* 


>• E5 * 


* EXECUTE IEMJZ * 


ZEND 

•••**J4*** ****••• 

* CLOSE DATA * 

* SETS, TIDYUP • 
>*PICKUP SEVERITY* 

* CODE * 


*. 


. * 


.* 


K1 *. 


*. 


.•HAS RETURN *. YES 

► . TO ZEND .* 

*. .* 

*. .* 

*. .* 

* NO 


*****K2********** 

* LOAD CLOSING * 

* NODULE AK * 
— >*UPDATE SEVERITY* - 

•CODE FOR BATCH * 

* * 


.* ANY MORE *. NO 

->*. COMPILATIONS .* 

♦ .IN BATCH .* 


♦♦•♦*J5*»*»*»**** 

* CLOSE SYSUT1 * 

* SCAN BATCH * 
>* DELIMITER * 

* RECORD FOR ♦ 

* SYNTAX ERRORS • 


••••♦K4********** 


* RELEASE AK 


• — 


•••*K5********* 
RETURN TO * 
>*CALLING PROGRAM* 

• • 




• *•• 

• * 

♦ E# * 

• * 
*••* 
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►Chart AT. Phase AT Overall Logic Diagram 


**«*A* ********* 

• ENTRY FROM ROOD* 
* IN AB ♦- 


INIT .*. 

A2 *. 

.* ♦. 

.* IS THIS A *. NO 

>*. TRACE CONTROL.* — 

A * . CARD . * 

*. .* 

*. . • 


**«**B2 ********** 

* CONSTRUCT A ♦ 

* CONTROL TABLE * 
-♦ENTRY. READ THE* 

* NEXT CARD * 


A3 *. 

.* ARE * . 

.* PHASES *. NO 

->♦. LOADED BEFORE.* 

*. AT IN- .* 
•VOLVED.* 

*. . * 

* YES 


CNTRL 

«****B3 ********** 

* CARRY OUT ANY * 

* REP OR VERIFY * 

* REQUESTS IN •- 

* THEM * 


****«B4 ********** 

* INSERT ANY * 

* TRACE MARKERS * 
->*IF REQUESTED IN*- 

* THEM * 


•***B5 •***••••• 

•RETURN TO RDCD ' 
•>* IN AB 


****C1********* 

► ENTRY FROM * 

► PHASE LOADING * 
* ROUTINE IN AA - 


NO 

PATCLOAD 

C2 *. *****C3********** 

.♦WAS REP*. *REP AND VERIFY * 

.♦ OR VERIFY ♦. YES ♦ AND PRINT * 

->*. REQUESTED IN .♦ >• MESSAGES IF *- 

♦. THIS .* * NECESSARY * 

•.PHASE.* ♦ • 

*. .* *.**♦*♦*♦**»**.** 


.* . 

C4 *. 

.* IS A *. 

TRACE * . NO 

WANTED IN .* 

. THIS . * 

* .PHASE.* 

♦ . . * 

YES 


TRACLOAD V 

*****D4********** 

* • 

* INSERT THE ♦ 

* START OR END *- 

* TRACE MARKERS * 


•***D5* ******** 

V * RETURN TO * 

>• LOADING ROUTINE* 

* IN AA * 


****E1 ********* 

* ENTRY FROM * 
♦PHASE DELETING *- 

* ROUTINE IN AA * 


TRACRELS 

*****E2**** ****** 


• UPDATE TRACE 
->*CONTROL TABLES 


♦••*E3*******»* 

* RETURN TO * 

-> ‘DELETE ROUTINE < 

♦ IN AA * 


♦♦♦•FI********* 

♦ ENTRY FROM * 

♦ INTERRUPT * 

♦ HANDLER IN AA • 


TRACEIT . * . 

F2 *. 

.♦IS THIS*. 

•*A START OR *. YES 

>*. END TRACE .* 

* . MARKER . • 


*. 


. ♦ 
NO 


****G2********* 

* RETURN TO * 

* INTERRUPT < 

* HANDLER IN AA * 


.* . 

F3 *. 

.* * . 

.* IS IT A *. NO 

->*. START TRACE .* 

*. MARKER .* 

* . . * 

* . .* 

* YES 


. *. 

G3 *. 

. * * . 

.* IS THE *. NO 

* . STMTFLG FLAG .* 

*. SET .* 


****»F4 ********** 

* REMOVE END • 

* TRACE MARKERS * 
->* AND INSERT *- 

* START TRACE ♦ 

* MARKERS * 
***************** 


.* 


.*. 

G4 *. 


* . 


.* 


.♦IS TRACE TO*. NO 

->*. START YET .* 

*. . * 

*. .* 

* . 


•*«*P5*« *•*•**• 

•RETURN CONTROL * 
->*VIA SUPERVISOR * 
* TO PHASE * 


* •* • *gS* ♦♦♦♦♦**♦* 
•RESTORE OPCODE.* 
•OVERWRITE NEXT * 
->* OPCODE WITH ♦ 

* START TRACE * 

* MARKER • 


* YES . 

YES 

' 

1 


****«B3 ********** 

♦RESTORE OPCODE. • 

* OVERWIRTE • 
•PREVIOUS OPCODE* 

* WITH START * 

* TRACE MARKBR * 


• «« 


♦PRINT HEADINGS 

* CHANGE RETURN 
♦ADDRESS IN PSW 
•IN PIE TO THAT 

* OF TRACE RTN 


••••*H5********** 


•SET ON STMTFLG * 
* FLAG * 


**«**J3 ********** 


•SET OFF STMTFLG* 

* FLAG *- 


•******•*•••*••** 


****J4********* 

♦ GO VIA * 

* SUPERVISOR TO • 

• TRACE ROUTINE • 


***.J5«* ******* 
♦RETURN CONTROL ♦ 
->*VIA SUPERVISOR * 
♦ TO PHASE * 


****KI ********* 
•ENTRY TO TRACE * 

* ROUTINE * 


TRACE V 

•****K2 ********** 

♦PUT INSTRUCTION* 
♦AND ITS ADDRESS* 

>• INTO TRACE *- 

* PRINT LINE * 


*****K3*» ******** 

♦EXECUTE I NSTFN . * 
♦PUT CC. CHANGED* 
->* REGISTERS AND ♦- 

* STORAGE INTO * 

* LINE * 


♦**K4**** ******* 


PRINT TRACE 
LINE 


>L**< 


* GET NEXT 
->* INSTRUCTION 


EXIT FROM THE ABOVE LOOP HILL OCCUR WHEN A PRIVILEGED OPERATION 
INTERRUPT OCCURS ON ENCOUNTERING AN END TRACE MARKER IN THE 
CODE BEING TRACED. 
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Table AA. Module AA Compiler Control Resident Control Phase 


Statement or Operation Type 


Initializes the compiler 

Parameters passed ? General register 1 points at 
the passed parameters 

Entry to the operating system : GETMAIN (R) , 

TIME, LINK, SPIE 


Deletes a list of loaded phases 

Parameters passed : PARI — address of list of 
phases to be deleted 

Entry to the operating systems DELETE 


Deletes a list of loaded phases and passes 
control to either the next requested phase or 
the next named phase 

Parameters passed : PARI — address of list of 
phases to be deleted; PAR2 — address of name 
of phase to which control is to be given, or 
zero 

Parameters returned : PARI — load point of new 
phase 

Entry to the operating system : DELETE , 
LOAD(EPLOC), LOAD(DE), LINK 

Loads the required phase and returns control to 
the caller. The phase may be loaded again 

Parameters passed : PARI — address of name of 
phase to be loaded 

Parameters returned : PARI — load point of 
phase 

Entry to the operating system: LOAD (DE) 


Main Processing 
Routine 


ZINIT 


RELESE 


RLSCTL 


LOADX 


Routine Called 


LOADW, ABORT 


ZUERR, ABORT 


Module AD if inter- 
phase dumping is req- 
uired; Module AE if it 
is end of Read- In 
Phase; ZUERR, ABORT 


ZUERR, ABORT 


j Marks phases as 'wanted' and 'not wanted* 

I 

I Parameters passed : PARI — address of 
jlist of phase names to be marked 'wanted;' 
j PAR2 — address of list of phase names to be 
j marked 'not wanted' 

I Entry to the operating system : None 

jputs a record out to SYSLIN 

I 

( Parameters passed : PARI — address of output 
j record 

I Entry to the operating system: PUT LOCATE (QSAM) 


REQEST 


ZUERR, ABORT 


LPERRX 


Puts a record out to SYSPUNCH 

Parameters passed : PARI — address of output 
record 

Entry to the operating system: PUT LOCATE (QS AM) 


SPERRX 
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Table AA. Module AA Compiler Control Resident Control Phase (cont'd) 




Statement or Operation Type 


Main Processing 
Routine 


Routine Called 


H 


Deletes currently loaded phases and passes 
control to the Error Editor 

Entry to the operating system : LOAD(EPLOC) if 
dump option specified 


Z ABORT, ABORT 


Module AD if dump op- 
tion specified; RLSCTL 


■H 


Picks up completion code and returns control to 
the program that called compiler 

Entry to the operating system ; TIME, FREEMAIN, 


ZEND 


ZUPL 


DELETE 

Handles all program checks 


PIH 


ZOERR 


-H 


Parameters passed ; ARINT holds address of 
routine wanting to handle interrupt. ARMASK 
holds mask indicating which interrupts it is 
desired to handle 

Entry to the operating system : None 


—j 

— i 

I 

— I 


L X X 

Table AAl. Module AA Routine/ Subroutine Directory 

Function 

Deletes currently loaded phases, passes control to error editor. 

Enters message "REFERENCED BLOCK NOT IN USE", then terminates 
compilation. 

Takes dictionary reference and points at relevant slot in dictionary 
control block area (DSLOTS) . 

Takes text reference and points at relevant slot in text block 
control area (TSLOTS) . 

Finds dictionary block which can be written on disk to make room for 
a new block in storage. 

Marks error on SYSLIN data set. 

Loads required phase and returns control to caller. The phase may 
be loaded again. 

Loads required phase and returns control to caller. 

Handles all program checks. 

Prints record on SYSPRINT data set. Pagination (paging action) is 
performed automatically. 

Marks error on SYSIN data set. 

Reads a block from disk. 

Releases all loaded phases. 

Marks phases as 'wanted' or 'not wanted.' 

Releases all loaded phases and passes control to next required or 
named phase. 


r T . 

| Routine/Subroutine | 


r 

j ABORT 

— T 

| BLKERR 


JCONSLD 


| CONSLT 


| DFREE 


| LFERRX 


| LOAD* 


| LOADW 


| FIE 


| PLERRX 


| RDERRX 


|READX 


j KELESE 


1 REQEST 


| ftLSCTL 



_ X 
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Table AA1. Module AA Routine/Subroutine Directory (cont'd) 


j Routine/Subroutine j Function j 


ISPERRX 

I 

| Marks error on SYSPUNCH data set. 



^ 

1 

j ZABORT 

i 

| Deletes currently loaded phases and passes control 

i 

to error 

editor, j 

1 

| ZEND 

1 

1 

I 

| Picks up the completion code for the 
jto ZINT to continue the batch, or to 
jof a single or batch compilation. 

i 

compilation and returns 
the operating system at 

control j 
the end | 

1 

jZINIT 

1 

[Initializes the compiler. 




1 

j ZULF 

1 

|Puts record out to SYSLIN data set. 

| 




1 

i ZOSP 

1 

|Puts record on to SYSPUNCH data set.. 



! 
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Table AB. Module A B Compiler Control Initialization 

f t t 

[Main Processing 

} Statement or Operation Type 

j Issues a BLDL macro instruction on all phases | PROPEN I None 

jin compiler, and constructs a compacted phase 
| diet ionary 

I 

I Entry to the operating system s BLDL 

y 


Routine 
PROPEN 


Routine Called 


H 


•H 


Prints initial headinq and performs scan of 
j option list. Default options are taken where 
j necessary 
1 

I Parameters passed : General register 1 points to 
j option list passed at invocation time 
I Entry to the operating system : TIME, 
j PUT LOCATE ( QSAM ) 

* 

| Makes the initial space allocation for text and 
j dictionary blocks. Sets up communication 
j region 

j Entry to the operating system : GETMAIN (R) 


OPTPROC 


None 




OPENR 


V 

J Opens spill file if text and dictionary blocks 
I are IK 

I 

I Entry to the operating system : OPEN 

y 


^OPENSP 


j Obtains the guaranteed UK of scratch storage 

I 

1 Entry to the operating system : GETMAIN (R) 

1- 


^GETSCR 


j Loads intermediate file writer (Module AC), 
j^ets buffer sizes for SYSUT3 and opens the data 
j set 

I 

1 Entry to the operating system : LOAD CEPLOC) , 

1 OPEN 


NODUMP 


^ 

| Prints out list of options for this compilation! 

I 1 

1 Entry to the operating system ; None 

j Enters error messages generated when SYSIN, 
j SYSPRINT opened 


NDMP 


None 


None 


None 


ZUPL (AA) 


ZUPL (AA) 


H 


^ 


-H 


1 


■H 


•H 


■H 


PJ13 


I Entry to the operating system ; None 

y- 


j Reads first card and stores. Uses as heading 
| if required 


+ 


RDCD 


+ 


j Return to pre-initializer in IEMAA 

K 


ABOUT 
+ 


ZUERR (AA) 


^ZURD, ZUERR, ZUPL 
(all in AA) 


None 


j Opens SYSPUNCH if MACDCK specified 

I 

1 Entry to the operating system : OPEN 

[loads dictionary handling control routines 
j (phase IEMAN or IEMAL depending on normal 
1 dictionary or extended dictionary being 
| specified in the options) 

I 

I Entry to the operating system : LOAD , 

L 


MCD 


^LODCNTL 


ZUERR 


None 


1 


._j 
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Table AB1. Module AB Routine/Subroutine Directory 


1 Foutine/Subroutine ( 
| ABOUT 
GETSCR 
NDMP 
NODUMP 


Function 

Returns control to pre-initializer in Module AA. 

Obtains scratch storage. 

Prints lists of options for current compilation. 

Loads intermediate file writer module AC. Sets buffer sizes for 
SYSUT3 and opens data set. 

OPENR | Makes initial space allocation for text and dictionary blocks. Sets 

up communications region. 

| OPfiNSP j Opens spill file. 

| OPTPROC | Prints initial heading and performs scan of option list. 

IPJ13 | Enters diagnostic messages generated when SYSIN and SYSPRINT data 

sets are opened. 

PROPEN | Issues BLDL macro instruction and constructs phase directory. 

|RDCD J Reads first card. 


Table AC. Module AC Compiler Control Intermediate File control 


- T T 

| Main Processing 
i Routine 

IIEMAC 


Statement or Operation Type 


| Writes a record onto SYSUT3 

I I 

I Parameters passed : PARI — address of output | 
j record; PAR2 — length of record j 

1 Entry to the operating system : PUT LOCATE (QS AM) j 

h 



|Link to file switching x*outine (Module AG) 

I 

I Entry to the operating system : LINK 


| ENDED 


Table AD. Module AD Compiler Control Interphase Dumping 


Statement or Operation Type 


Routine Used 


T T * 

| Main Processing! 

| Routine | 

+ + 1 

(Debugging aids. This routine contains a dump- | IEMAD | ZDRFAB, ZTXTAB , ZUPL | 

jing program which is invoked by use of the DUMP j j (all in AA) , \ 

j option j | DUMP | 

L X X J 


Table ADI. Module AD Routine/Subroutine Directory 


j Routine/Subroutine j Function | 

Y + 1 

(DUMP (Converts contents of specified area of main storage to hexadecimal, | 

J (prints the result. | 


Chapter 3: Flowcharts, Tables, and Routine Directories 79 









Table AE. Module AE Compiler Control Clean-Up Phase 

Main Processing 

Statement or Operation Type 


Routine 
IEMAC 

(Module AC) 


Routine Called 


4 


Input and intermediate file control. Current 
input file is closed and IEMAC is deleted if 
present 

Entry to the operating system : CLOSE ( current 
input file) , DELETE 


None 


^ 


Opens SYSLIN and SYSPUNCH data sets if required 
Entry to the operating system : OPEN 


NOT48 




ZUERR (AA) 


^ 


Expands the number of blocks in storage to four 
text and four dictionary, if running with the 
44k size option 

Entry to the operating system : GETMAIN 


NOTDCK 


None 


._j 


Table AE1. Module AE Routine/Subroutine Directory 


— i 

I 

■H 

I 

I 

I 

— j 


j *<outine/Subroutine j 

t" 


Function 


NOT 4 8 

i 

j NOTDCK 
L 


j Opens SYSLIN and SYSPUNCH data sets as required, 

I 

| Expands number of blocks in storage. 


Table AF. Module AF Compiler Control Sysgen Options 

r 

| Function 

JThis module contains no executable instructions. It is 
{generated at SYSGEN time and passes the default options 
jand values to the compiler 


| None 


Subroutines | 

^ 


_j 


Table AG. Module AG Compiler Control Intermediate File Switching 

[ Function | Subroutines. | 

j. r + \ 

| Switches SYSUT3 from an output file to an input file |None | 

I II 

I Entries to the operating system : OPEN and CLOSE | | 


Table AK. Module AK Compiler Control Closing Phase 


Function 


j Closes files, frees scratch core and deletes unwanted 
j phases 


1 Subroutines I 

IZURC(AA) | 


jlf batch compiling, scans batch delimiter card for correct j 
| syntax and updates completion code. | 

i ! 

I Entries to the operating system : TIME, CLOSE, FREEPOOL, | 

| DELETE, and FREEMAIN | 
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Table AL/AN. Modules AL/AN Extended Diet ionary /Diet ionary Phases 


Statement or Operation Type 


T T 

Main Processing! 
Routine 


Routine Called 


H 


Releases scratch storage allocated by ZUGC 

Parameters passed : PARI — a count of the 
number of entries to ZUGC to be released 
Entry to the operating system : FREEMAIN if 
storage being replaced is outside the guaran- 
teed 4K block 


ZURC 


ZUERR, ABORT 


+ ^ 

ZDRFAB , ZDICRF, ZDICAB 


Inserts diagnostic message in the dictionary 

Parameters passed : PAR 5 — numeric parameter 
(if any); PAR6 — message number; PAR 7 — add- 
ress of text (if any) or dictionary reference 
(if any); PAR8 — length of text (if any) 
Entry to the operating system : None 


ZUERR 


•H 


Takes a dictionary reference and points at the 
relevant slot in the dictionary block control 
area (DSLOTS) 

Parameters passed : PARI — dictionary 
reference 

Parameters returned : Address of slot in GRA 
Entry to the operating system ; None 


CONSLD 


None 


Takes a text reference and points at the 
relevant slot in the text block control area 
(TSLOTS) 

Parameters passed : PARI — text reference 
Parameters returned : Address of slot in GRA 
Entry to the operating system s None 

Allocates space for a text block 

Parameters passed : Relative track address of 
the block (if block is on disk) in RDTTR. 
Otherwise RDTTR is zero 

Parameters returned : Address of blbck in GRO 
Entry to the operating system : GETMAIN (VC) if 




CONSLT 




•H 


^TRYMRT 


+ ^ 

DFREE , TFREE , ZUPL, 

ABORT 


storage available, 
for text blocks 


OPEN if no space left 


+ 


^ 


Allocates space for a dictionary block ITRYMRD 

Parameters passed : Relative track address of 
block (if block is on disk) in RDTTR. Other- 
wise RDTTR is zero 

Parameters returned : Address of block in GRO 
Entry to the operating system : GETMAIN (VC) if 
storage available. Open if no apace left for 
dictionary blocks 

Investigates the dictionary block control used I DFREE 
(DSLOTS) , to find which block can be written on 
to disk to make space for a different block in 
storage 

Parameters passed : Relative track address of 
block required in storage in RDTTR. RDTTR=0 
if a block is being created 
Parameters returned : Address of block in 
storaoe in BLOKAD 

Entry to the operating system : None 


DFREE, TFREE, ZUPL, 
ABORT 


+ ) 

CONSLD, ZUERR, ABORT, 
WORE AD, WRTRD, WDWRIT 


„_J 
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Table AL/AN. Modules AL/AN Extended Dictionary/Dictionary Phases (cont'd) 




Statement or Operation Type 


Main Processing 
Routine 


Routine Called 


■H 


Investigates the text block control area 
(TSLOTS) , to find which block can be written 
onto disk to make space for a different block 
in storage 

Parameters passed : Relative track address 
block required in storage in RDTTR. RDTTR=0 
if a block is being created 
Parameters returned : TFREE 
Entry to the operating system : None 


TFREE 


CONSLD, ZUEP.R, ABORT, 
WDREAD , WRTRD , WDWRIT 






Create space in storage by writing on disk 

Parameters passed ; RDTTR=0, BLOKAD contains 
address of block that can be written out 
Parameters returned : BLOKAD contains address 
of block in storage that is now available 
Entry to the operating system : WRITE (BSAM), 
CHECK, NONE 


WDWRIT 


WRITEX 


+ 

WRTRD 


— 1 


Writes a block onto disk and reads a second one 
into its place in storage 

Parameters passed ? RDTTR contains relative 
track address of Dlock to be read. BLOKAD 
contains address of block to be written 
Parameters returned ; NOTTR contains relative 
track address of block in storage 
Entry to the operating system : WRITE ( BS AM) , 
CHECK, NOTE 


READX, WRITEX, ZUERR, 
ABORT 


■H 


Reads a block from disk into space already 
available in storage 

Parameters passed ; RDTTR holds relative track 
address of block to be read. BLOKAD holds 
address cf space in storage 

Parameters returned : BLOKAD holds address of 
block in storage 

Entry to the operating system ; None 


WDREAD 


READX 


Writes a block onto disk 

Parameters passed : TEMP4 holds relative track 
address of space on disk 

Entry to the operating system ; XDAD(WI), WAIT 


^WRITEX 


+ 

ZUPL, ZEND 


-1 


Reads a block from disk 

Parameters passed : TEMP4 holds relative track 
address of block on disk 

Parameters returned : PARI — address of input 
area 

Parameters returned : PAR2 — record length 
Entry to the operating system ; GET MOVE (OS AM) 


READX 


ZUPL, ZEND 


Reads a record from SYS IN 

Parameters passed : PARI — address of input 
area 

Parameters returned : PAR2 — record length 
Entry to the operating system : GET MOVE (QSAM) 


+ 

ZURD 


None 


■H 
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Table AL/AN. Modules AL/AN Extended Dictionary /Dictionary Phases (cont'd) 


Statement or Operation Type 


Main Process ing 
Routine 


T 1 

Routine Called 


h 


Puts a record out to SYSPRINT. Pagination 
(paging action) is performed automatically 

Parameters passed : PARI — address of output 
buffer. PAR 3 — address of output buffer 
containing page heading (if any) 

Entry to the operating system : PUT LOCATE 
(QSAM) 


ZUPL 


PLERRX 


■H 


Finds a new text block. Optionally chains the 
new block to the current block and changes the 
status of the current block 

Parameters passed : PARI — optionally, a 
reference to the current block. PAR2 — a 
status and chain indicator 

Parameters returned : PARI — reference to new 
block; PAR2 — absolute address of the 
beginning of block 

Entry to the operating system : Hone 


ZUTXTC 


CONSLT , TRYMRT, ZUERR, 
ABORT, BLKERR 


-H 


Finds the next text block in the chain. 
Optionally, changes the status of the current 
block 

Parameters passed : PARI — a reference to the 
current block; PAR2 — a status indicator 
Parameters returned : PARI — reference of the 
next block in the chain. PAR2 — absolute 
address of next block in chain 
Entry to the operating system : None 


ZCHAIN 


Changes the status of the referenced text block 

Parameters passe d: PARI — a reference to the 
block. PAR 2 +3 — required 'status' byte 
Entry to the operating system : None 


ZALTER 


CONSLT, TRYMRT, BLKERR 


+ 

CONSLT, BLKERR 


H 


Converts a text reference to an absolute 
address and optionally, does not change status 
of the block 

Parameters pasoed : PARI — reference to be 
converted and option indicator bit 
Parameters returned ; PARI — the absolute 
address 

E ntry to the operating system : None 


ZTXTAB 


CONSLT, TRYMRT, BLKERR 


Converts an absolute address to a text 
reference 

Parameters passed : PARI — a text reference to 
the block containing the absolute address; 

PAR 2 — the address to be converted 
Parameters returned : PARI — the required text 
reference 

Entry to the operating system ; None 


ZTXTRF 


Enters iressaoe 'REFERENCED BLOCK NOT IN USE' 
into dictionary and then terminates compilation 
E ntry to the operating system : None 


BLKERR 


CONSLT, BLKERR, ZUERR, 
ABORT 


ZUERR, ABORT 


._J 
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Table AL/AN. Modules AL/AN Extended Dictionary /Dictionary Phases (cont'd) 





ZUGC 


TRYMRT , ZUERR, ABORT 


^ ZDABRF 




CONSLD, ZUERR, ABORT, 
BLKERR 




Supplies storage space for scratch purposes. 

Allocation is made in 512 bytes at a time 
Parameters passed : PARI — a count of the 
number of 512 byte blocks required 
Parameters returned : PARI — address of the 
allocated storage 

Entry to the operating system ; None 

Converts an absolute address to a dictionary 
reference 

Parameters passed : PARI — any reference to 
the block containing the absolute address; 

PAR2 — the absolute address to be converted 
Parameters returned : PARI — 1 the required 
dictionary reference 
Entry to the operating system : None 

Converts a dictionary reference to an absolute jzDRFAB |consl6, TRYMRD, BLKERR ^ 

address 

Parameters passed : PARI — the dictionary 
reference 

Parameters returned : PARI — the absolute 
address 

Entry to the operating system : None 




Statement or Operation Type 




Makes an unaligned dictionary entry and 
returns an absolute address 

Parameters passed : PARI — address of entry to 
be made; PAR 2 — length of entry 
Parameters returned : PARI — address of entry 
in dictionary. PAR4 — some reference to the 
block 

Entry to the operating system : None 


Main Processing 
Routine 


ZNALAB 


Routine Calles 


ZDRFAB, ZDABRF, TRYMRD, 
ZUPL, ZUERR, ABORT, 
CONSLD 


-H 


Makes an aligned dictionary entry and returns 
an absolute address 

Parameters passed : PARI — address of entry to 
be made; PAR2 — length of entry 
Parameters returned ; PARI — address of entry 
in dictionary. PAR4 — some reference to the 
block 

Entry to the operating system : None 


ZDICAB 


ZDRFAB, ZDABRF, TRYMRD, 
ZUPL, ZUERR, ABORT, 
CONSLD 


^ZNALRF 


Makes an unaligned dictionary entry and 
returns dictionary reference 

Parameters passed : PARI — address of entry to 
be made; PAR 2 — length of entry 
Parameters returned : PARI — reference of 
entry in dictionary. PAR4 — absolute address 
of the entry 

Entry to the operating system : None 


ZDRFAB, ZDABRF, TRYMRD, 
ZUPL, ZUERR, ABORT, 
CONSLD 


Makes an aligned dictionary entry and returns a | ZDICRF 
dictionary reference 

Parameters passed : PARI — address of entry to 
be made; PAR2 -- length of entry 
Parameters returned : PARI — reference of 
entry in dictionary. PAR4 — absolute address 
of the entry 

Entry to the operating system : None 


1 

ZDRFAB, ZDABRF, TRYMRD, 
ZUPL, ZUERR, ABORT, 
CONSLD 
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Table ALl/ANl. Modules AL/AN Routine/Subroutine Directory 


j Routine/Subroutine | Function j 


j TFREE 

| Finds text block which can be written on disk 
jto make space for a new block in storage. 

i 


| TRYMRD 

l 

(Allocates space for a dictionary block. 


| TRYMRT 

l 

(Allocates space for a text block. 

1 


| WDREAD 

1 

| Reads a block from disk into storage. 

i 


| WDWRIT 

1 

| Creates space in storage by writing a block on 

|disk. 

■ 


| WRITEX 

1 

| Writes a block on disk. 

1 


| WRTONL 

1 

(Writes on last block on disk. 

I 


| WRTRD 

1 

| Writes a block onto disk, reads a second one 
jinto its place in storage. 

1 


| ZALTER 

i 

| Changes status of referenced text block. 

i 


| ZCHAIN 

1 

| Finds next text block in chain. 


| ZDABRF 

1 

(Converts an absolute address to a dictionary 

j reference. 

1 


| ZDRFAB 

(Converts a dictionary reference to an absolute 

(address. 

1 


| ZDICAB 

1 

| Makes an aligned dictionary entry and returns 

j absolute address. 

1 


| ZDICRF 

1 

| Makes an aligned dictionary entry and returns 
j dictionary reference. 

i 


| ZNALRF 

(Makes unaligned dictionary entry and returns 
(dictionary reference, 
j 


| ZNALAB 

(Makes unaligned dictionary entry and returns 
| absolute address. 


| ZTXTAB 

1 

(Converts text reference to an absolute address. 

1 


| ZTXTRF 

(Converts absolute address to a text reference. 

i 


| ZUERR 

1 

) Inserts diagnostic message in dictionary. 

1 


| ZURD 

1 

| Reads a record from SYSIN. 

I 


| ZUGC 

1 

(Supplies storage space for scratch purposes. 

i 


| ZURC 

l 

(Releases scratch storage, 
j 


| ZUPL 

|Puts record out to SYS PRINT data set. 

| 


1 ZUTXTC 

1 

(Obtains a new text block. 
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Table AM. Module AM Compiler control Phase Marking 


| Function 

(Marks all non-optional phases and 
jail phases influenced by compiler | 
j invocation-time options j 


(Main Processing! 
j Routine f 
+ + . 


Routines Used 


I IEMAM 


j REQEST, RLSCTL (both in AA) 




j 


•Table AT. Module AT Compiler Debugging Module 






h 


Statement or Operation Type 


Main Processing 
Routine 




Reads in control cards and 
constructs control tables 
Entry to the operating system s None 




Entered each time a phase is loaded 
so that replacing (REP) or 
verifying may be done. Inserts 
start or end trace/flow markers 
(privileged operations) 

Entry to the operating system : None 




Entered each time a phase is 
deleted and updates control tables 
Entry to the operating system : None 


Entered from Interrupt Handler in 
module AA after privileged 
operation encountered ( 0C2 
interrupt) signifying trace/flow 
marker. Carries out initialization 
before starting or after ending 
trace/flow 

Entry to the operating system : None 


Analyzes each instruction to be 
traced. Executes the instruction 
and prints a line containing: the 
instruction, its address, the 
resulting condition code, and the 
subsequent contents of registers 
and storage used by the 
instruction. 

Entry to the operating system : PUT 


MODE (QSAM) 


INIT 


LOAD 


TRACRELS 


TRACEir 


TRACE 


Routines Used 


CNTRL, NXTFLD ,TR OFFSET, ZUPL (AA) , 
ZURD(AA) 


PATCLOAD, TRACLOAD , ATCALL, HEXOUT, 
JBPT 


None 


ATCALL, JBPT 


CALL , FULLSUB , FULL 2 , JBPT , FULLAD 


H 


._j 
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Function 




•Table ATI. Module AT Routine/Subroutine Directory 
r t 


I Routine/Subroutine I 


[atcall 
| CALL 
| CNTRL 

| FULLAD 

| FULLSUB 

| FULL2 

| HEXOUT 
IINIT 


| Calls the print routine and then clears the print line. | 

I I 

| Similar function to ATCALL but contained within TRACE routine. j 

1 I 

| Carries out replacing (REP) and verifying in phases loaded before | 
j AT. Inserts start trace markers in phases loaded before AT. | 

I I 

j Determines address of storage to be altered by instruction currently! 
j being traced. | 

I I 

| Translates hexadecimal to a character representation of hexadecimal.! 
jused in TRACE routine. j 

I I 

! Analyzes instructions to be traced and moves information to the | 

| print line. | 

I I 

| Similar function to FULLSUB. Used in routine LOAD. | 

I I 

| Builds control fields using information from control cards in the | 
J input. | 


JJBPT | Prints a line of trace information. | 

| LOAD j Controls subroutines PATCLOAD and TRACLOAD. j 

I I I 

j NXTFLD | Skips blank characters on input control cards. | 

I I I 

| PATCLOAD J Carries out replacing (REP) , if requested, after each phase is ! 

j | loaded. j 

I I I 

j TRACE J Traces each instruction and prints trace information. | 

I I I 

j TRACEIT | Describes whether TRACE/FLOW must start or end. J 

I I I 

JTRACLOAD J Inserts start trace markers in phases after they have been loaded. | 

II I 

|TRACRELS | Updates control tables when a phase is deleted. | 

|TROFFSET j Translates character representation of hexadecimal to hexadecimal. j 
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Chart 01 


Compile-time Processor Logical Phase Flowchart 
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Chart AS. Phase AS Overall Logic Diagram 
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Chart AV. 


Phase AV Overall Logic Diagram 
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Chart BC. Phase BC Overall Logic Diagram 
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Chart BG. Phase BG Overall Logic Diagram 
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Chart; BM. Phase BM Overall Logic Diagram 
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♦ BUFFER 



***J4*********** 

► PUT OUT * 
DIAGNOSTIC 
MESSAGE * 


.♦ WAS ♦. ♦♦♦♦ 

0 .* THIS *. YES * * 

-♦. LAST ENTRY .* >* D4 * 

♦.IN CHAIN .* * ♦ 
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Chart BW 


Phase BW Overall Logic Diagram 


♦♦♦•Al********* 

RELEASE 
AMY LOADED 
PHASES 

*«»*****#*•«»** 


*****i>l*# ******* * 
* * 

* RELEASE ALL * 
* ACTIVE TEXT AND* 

* D1CT BLOCKS ♦ 


►♦♦♦Cl********** 

F^EE * 

ANY • 

outstanding * 

SCRATCH STORAGE ♦ 


***D2*********** 


***** 
♦AA ♦ 
• HU* 


***** FI ********* 
* 

* REALLOCATE 

* TEXT AND 

* DICT BLOCKS 


*****G2********* 


****H1* ******** 

SET UP 

COMMUNICATIONS 
REGION 
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Table AS. Phase AS Resident Phase for Compile-time Processing 


Statement or Operation Type 


|Main Processing! 
Routine 


Subroutines Used 


— i 


■H 


| Initializes switches for 
j compile- time processor 

h 


I ADRP 


None 


I 


-H 


| Loads phases for compile-time | ADRP 

j processor j 

(Determines whether Phase BC should | ADRP 

j be reloaded j 


j LOADX (AA) 

I 

4 - 


None 
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Table AS1. Phase AS Routine/subroutine Directory 
| Routine/Subroutine \ 


ADRP 
BCKUP2 
CHBLK 
CLSBUF 

COMENT 

ENDIVB 

FREVAL 

GETIVB 

GNC 

HASH 

INCTST 

INPUT 

INHO 

NXTTXT 

OUTPTC 

SRHDIC 

STRING 

TOKSCN 

UPNEWL 

YAG2 


— 1 
I 

H 


Function 

Initializes switches for compile- time processor. 

Backs up token pointer two places. 

Changes currently busy IVB block status and gets a new block 

i Handles calls to close and write out the buffer. Loads and bases 
phase BJ if necessary. 

| Scans the limits of a comment, transfers each character into the 
output buffer. 

Closes an IVB chain. 

j Releases a chain of IVBs containing a no longer needed value and 
returns chain to free list. 

[Removes an IVB from the free chain for use by the calling routine. 

Updates TOKPTR to point to the next character in a particular input 
stream. 

j Accepts an EBCDIC identifier as input and outputs an index. The 
index indicates the beginning of the HASH chain with which the 
identifier is associated. 

[Determines whether Phase BC needs to be reloaded on return from 
Phase BG. 

I 

Reads in an input record from the source data set or from included 
| text . 

[Reads physical records from the included data set; unblocks and 
sends them back one logical record at a time. 

iGets a new text block and sets up address slots. 

[Outputs a single character into one of the three output media: 

[ IVB* s, text blocks, or external records. 

Searches the dictionary for the presence of a named item. 

Scans the limits of a string constant, transfers each character to 
[ output . 

[Examines text, character by character recognizing and returning each| 
logical unit of text (called a token). Tokens include identifiers, 
[constants, operators, delimiters, etc. 

j Updates temporary linecount slot. 

| Loads processor phases for the compile-time processor. 
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Table AV. Phase AV Macro Processing Initialization 


1 

| Statement or Operation Type 

|Main Processing! 
j Routine j 

Subroutines Used 


j Initializes communication area for 
jcompile-time processing 

i 

j INIT 
] 

T 

| None 

I 

1 



r — 

| Allocates push down stack from 
| scratch storage 

| INIT 

1 

j . - 

T 

| None 

1 

.... .1 



j Allocates translation tables 

j INIT 

T 

| None 

i 



| Enters SUBSTR into dictionary 

j INIT 
j. r . 

T 

| None 

J. 



| Creates dictionary entries and 
lvalues for constants pool 

i INIT 

1 

.1 _ 

T 

| None 

1 

L 




Table AVI. Phase AV Routine/ Subroutine Directory 

I Routine/Subroutine | Function | 


* 

j INIT 


| WWN048 

I 

I 

j WWOVLP 

I 

I 

j WWOBCD 

I 

j WWCHNBEG 

I 

I 

j WWMOVEIT 

! 

| INCLUDE 

I 

j LABELS (BC 

I 

| GOTO Subroutine 

I 

| ACT Package) 

I 

| ELSE 


| Entry point to the initialization phase. This initializes the | 

j communication region for compile-time processing. j 

! I 

| Allocates the push down stack (to be used by Phases BC and BG) from | 
j scratch storage. | 

j Sets up tables to translate external code to EBCDIC; tests the j 

| BCD, EBCDIC option. I 

I i 

| Enters built-in function SUBSTR into dictionary. | 

I l 

| Creates dictionary entries and values for compile-time constant | 

jpool. I 

j Moves Subroutine package into core for use by BC. j 

| INCLUDE Processor I 

I I 

| LABEL List Processor. I 

j GOTO Statement Processor . . I 

j Active/Deactivate Processor. j 

1 I 

{ELSE Clause Processor. J 
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Table BC. Phase BC Initial Scan and Translation 

r r r t 

| | Main Processing | j 

j Statement or Operation Type j Routine j Subroutines Used | 

j Recognizes statement type JPH1SCN J TOKEN, DELETE | 

+ + ^ 

j Scans until next % character JPHlSCN |FINDPC j 

y + + ^ 

| Processes PROCEDURE statement jPHlSCN | TOKEN, DELETE, IDSRCH, | 

| j j ADDSP (FREVAL, OUTPTC) | 

h + + A 

j Processes labels attached to | PH1SCN | IDSRCH j 

| statement j j j 

^ + + 1 

j Encodes statement into internal JPHlSCN j PARSE, TOKEN, IDSRCH, ADDSP | 

| text | | DELETE, CHECK j 

I* + + "I 

jCleans up after INCLUDE in initial jPHlSCN | None j 

j scan j | | 

Y + + — ^ 

| Begins statement identification |PH1SCN | None | 

j process 11 I 

L X X J 
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Table BCl. Phase BC Routine/ Subroutine Directory 


j Routine/Subroutine j Function j 

* + ^ 

IADCONS (Obtains the dictionary reference of a constant, entering it into the| 

dictionary if necessary. 

! 

Adds a processor-created item to the dictionary. 

Adds a normal item to the end o f the appropriate hash chain and 
returns the dictionary reference. 

| Processes PROCEDURE statement. 

Processes assignment statements. 

Checks back for undefined labels and identifiers not declared within 
| the block. 

| Declare statement processor. 

Skips over bad text up to the end of a statement, field or 
procedure. 

DO statement processor. 

i Checks stack for possible THEN'S or ELSE's after statement is 
completed. 

Scans source text, character by character, searching for macro 
percent character. 

Obtains the dictionary reference of an identifier, entering it in 
| the dictionary if necessary. 

IF statement processor. 

| Checks for single or multiple keywords. 

Parses and generates interpretive macro code for compile-time 
expressions. 

Provides special handling for end of included text. 

| Mb in controlling routine for phase. 

Processes RETURN statement for PROC. 

Collects labels into label list and identifier statement type on 
first two tokens of statement. 


ADDSP 

! 

| ADICT 

I 

j ADPRCC (BF) 

| ASSIGN 
CHECK 

IDECLAR (BF) 

| DELETE 

DO (BE) 

DONE (BE) 

PI NO PC 

IDSRCH 

IF (BE) 
KYVDSR 
PARSE (BE) 

PIF4 

FH15CN (F£) 
| RETURN 
5TB3 

STMT (BE) 

1 TOKEN 

UPDI.IN 


(Diagnoses statement type and builds label list. 

Returns significant tokens to PH1SCN and writes out diagnostics for 
tokens in error. 

Generates an update linecount instruction 


i J 

Note: See also BC Subroutine Package in Table AVI. 
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Table BG. Phase BG Final Scan and Replacement 


r T T 1 

| | Main Processing! | 


j Statement or Operation Type 

L 

| Routine 

1 

Subroutines Used 

i 

|£inal scan for 

replacements 

j PH2SCH 

j OUTPUT, 

T0K3CN, 

SRHDXC 

1 

• 

j Recognition of 

i. ... - _ 

end of text 

| PH2SCN 
v 

J OUTPUT, 

i 

TOKSCN, 

SRHDIC 

i 

i 

I 

| Recognition of 

an identifier 

T 

J PH2SCN 

j OUTPUT, 

X 

TOKSCN, 

SRHDIC 

■ 

| Recognition cf 

macro action 

| PH2SCN 

T 

| OUTPUT, 

i 

TOKSCN, 

SRHDIC 


| 

j Recognition of 

% character 

I PH2SCN 

j . .. 

i OUTPUT, 
j. 

TOKSCN, 

SRHDIC 

.j 

_ 4 

j Recognition of 
| 

other characters 

| PH2SCN 

- 1 

j OUTPUT, 

TOKSCN, 

SRHDIC 

1 

4 

r 

| Terminates and 
j handling 

I 

cleans up INCLUDE 

T 

| PH2SCN 

1 

| OUTPUT, 

i 

X_ 

TOKSCN, 

SRHDIC 

1 

— 

r 

| Re-establishes 
j level text 

L 

scan at next higher 

JPH2SCN 

1 

T 

| OUTPUT, 

1 

-j. 

TOKSCN, 

SRHDIC 


r 

| Performs replacement on activated 
j identifiers 

1 

j PH2SCN 

1 

-X 

j OUTPUT, 

1 

L_ _ _ 

TOKSCN, 

SRHDIC 

_ J 


Chapter 3: Flowcharts, Tables, and Routine Directories 99 





Table BG1. Phase BG Routine/subroutine Directory 


| Routine/Subroutine | 


Function 


r - 

jCLCUT (BJ) 

1 

| CONVRT 


| DACLN 


1 DAEOB 


| DAE03F 


| DAIDEN 


|DAMAC 


| DAOTHR 


| DAPENT 


| DAPRTC 


| FUNCTN(BJ) 


| GFTDIC 


| INCONT 


J INTPRT (BI) 


| OUTPT 


| PH2SCN 


|POP 


| PROINV (BI) 


| PUSH 


| PUNCH (BJ) 


| SYNCH 


| TPEEK 


|ZAASIGN (BI) 


|ZAC0MP (BI) 


|ZACONCAT (BI) 


| ZACVT (BI) 


| ZALGCL (BI) 


IZAPUSH (El) 

J 


Closes output buffer, and writes out record on SYSUT3. 

Handles conversions between the three data types used in the 
compile- time processor . 

Terminates INCLUDE text handling and frees text blocks containing 
included text. 

Re-establishes scan at next higher ievel text. 

Recognizes and processes end of text condition. 

Recognizes and processes identifier in text. 

Recognizes and processes macro action character. 

Recognizes character and outputs it. 

Handles replacement operation for text identifiers. 

Recognizes % character and recalls Phase BC if appropriate. 

Handles built-in functions. 

Picks up a two-byte dictionary reference from scrubbed text, 
performs error checking, resolves indirect references, and returns 
both relative and absolute address. 

INCLUDE control routine. Opens DCB, finds member, sets up buffer, 
and initiates look-ahead read. 

Interprets the macro code generated by the Phase I scan. 

Handles the output of tokens. 

Scans text blocks. 

Pops the top temporary off the Phase II stack. 

Special entry point to interpreter for invocation of procedures 
found in source program text. 

Pushes next available temporary onto the Phase II stack. 

Punches down output record, in source code, on MACDCK option. 
Synchronizes linecount, closing buffer if necessary. 

Scans for procedure reference argument list left-parenthesis. 
Performs identifier assignments for INTPRT. 

Performs all logical comparison operations -for INTRPT. 

Performs string concatenations for INTPRT. 

Converts stack items to required type by 'RETURNS' attribute. 
Performs all logical operations for INTPRT. 

Performs stack maintenance for INTPRT. 
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Table BG1. Phase BG Routine/subroutine Directory (cont'd) 


r t 

| Routine/Subroutine | Function 

j. 1 

| ZARITH (Bl) | Perforins all arithmetic operations for INTPRT. 

I I 

| ZATRAI (El) JHandles transfers from included text to including text. 

I I 

| ZATRAN (BI) | Performs all transfer operations for INTPRT. 

I I 

j ZJSUES (BJ) | Built-in function SUBSTR. 


H 
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Table BM. Phase SM Diagnostic Message Determination and Printing 


Statement or Operation Type 

jMain 

1 

Processing! 

Routine j Subroutines Used 

X 


Determines whetner error messages 
are to be printed 

|XA 

1 


T 

| None 

1 

i ... . ... . . 

_| 

Scans error message text skeletons 
an 3 prints them out. 

j XA8 

1 


| XA5Q , XA70, XA90, XA110, ZUPL 

1 

J 


._j 


Table BMl. Phase BM Routine /Subroutine Directory 

Function 

[Determines whether error messages are to be printed. 

Sets severity code. 

[Establishes which message types to suppress, 
j Counts number of error chains to be processed. 

Puts out messages if there are no diagnostics. 

Prints out "COMPILER DIAGNOSTIC MESSAGES". 

First scan of message chains. 

Scans error message text skeletons and prints them. 

Scans to head of next non-empty chain. 

[Selects and prints header for messages of given severity. 
[Gets next entry in message chain. 

Builds up first part of message in buffer. 

Accesses message skeleton. 

Puts out completed message. 

Moves message text to print buffer. 


| Routine/Subroutine | 

j. ^ ^ 

|XA 

I 

XAO 
XA01 

! 

XA1 

| XA2 

1 

IXA4 
XA7 
XA8 

XA9 (BN) 

XA12A 
XA30 (BN) 

XA32 (©N) 

XA35 (BN) 

XA4Q (BN) 

XA50 (BN) 

[XA70 (BN) 


[XA90 (BN) 

XAUO (BN) 
ZUPL 


[Converts binary statement number to character representation, and 
j moves it to print buffer. 

Converts binary numeric value to character representation and moves 
it to print buffer. 

j Moves identifier from dictionary entry to the print area. 

Prints a line on SYSPRINT data set. 
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Table BW. Phase BW clean-up Phase 


r 

I 

j Statement or Operation Type 

j Resets all tables and 
j communications region cells to the 
j value required by the compiler 
j proper 


JMain Processing} 

| Routine j 

-+ — i 

j IEMBW | None 



Subroutines Used j 

! 


I 

j 
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Chart 02. Read-In Logical Phase Flowchart 


. * CHARACTER *. 
' ♦ . OPTION . * * 


♦****Bl **♦♦**♦♦♦* 

♦ 1ST PASS Cl* 

*.*.+.*.*_*..*.+..* 

♦ LIST IF REQ' D ♦ 
♦AND CONVERT TO ♦ 
♦INTERNAL CHARS ♦ 
♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 


** ♦♦♦Cl* **♦*♦♦♦♦* 
♦MAKE DICT ENTRY* 
♦FOR LABELS AND * 

* CHECK FOR * 

* LOGICAL END * 

* OF PROGRAM * 
♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 


CL* 


♦ ♦♦♦♦£>!♦♦♦♦ 

♦ 2ND PASS 
♦.♦_♦•♦•♦.♦ 

♦ SCAN TEXT TO ♦ 
♦ANALYZE SYNTAX * 

♦ OF STATEMENTS ♦ 
♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 


♦♦♦♦♦A2********** 

* 48-CHAR BX« 
♦-♦-♦-♦-♦-♦-♦.♦-♦ 

>♦ CONVERT TO * 

* 60 CHARACTER • 

* SET ♦ 


El *. 

. * ANY * . 

.* ALLOCATE. *. 
*. DECLARE, CALL.* 
♦STATEMENTS.* 


*****E2********** 

* 3RD PASS CO* 
*-*-♦-*-*-*-♦-♦-♦ 

->* SCAN TEXT TO * 
♦ANALYZE SYNTAX * 

* OF STATEMENTS * 
***♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 


FI *. 

.* ANY ♦. 
.♦STREAM I/O * 
. OR FORMAT 
♦STATEMENTS. * 


♦ . 


. ♦ 


♦****F2* ♦♦♦*♦♦♦♦♦ 

* 4TH PASS CS^ 
♦-♦-♦-♦-♦-♦-♦-♦-♦ 

->* SCAN TEXT TO * 
♦ANALYZE SYNTAX ♦ 

* OF STATEMENTS ♦ 
♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 


♦♦♦♦♦££♦♦♦♦♦♦♦♦*♦ 

♦ 5TH PASS CV* 
♦.♦.♦_♦-♦_♦_♦-♦_* 
♦MAKE CHAINS OF * 
♦CALL. DECLARE, * 

* ALLOC. S PROC * 
♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦ 


♦ ♦♦♦ 

♦ 03 * 
->* A1 
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Chart BX 


Phase BX Overall Logic Diagram 


• A2 * 
***♦ 


*•*••. 41 ********* 

* 

• READ AND 


♦♦•**A2********< 

* SCAN FIRST 
>* COPY OF 

* THE TEXT 


NEAR 
END OF 
RECORD 


«***B2**«**+*** 

READ ONE 
RECORD 
AHEAD AND 
TACK IT ON 


. ♦ START * . 
. OF COMMENT . 
♦.OR STRING. ♦ 


SET 

APPROPRIATE 
SWITCH ON 


♦ END ♦. 

OF COMMENT . 
♦.OR STRING. ♦ 


.♦ POSSIBLE ♦. YES 

►. KEYWORD. .♦ 

♦PERIOD. OR . ♦ 

♦ .COMMA. ♦ 


**+**D2* ♦♦♦♦♦♦♦< 

* SET 

>♦ APPROPRIATE 

♦ SWITCH OFF 


.♦ IN « 
->♦. COMMENT 

♦.OR STRING. « 


.♦ END 
OF 

♦. RECORD 


♦ •** 

NO ♦ ♦ 

* >♦ A2 • 

* * 
♦ •** 


****54********* 

IGNORE 

*************** 


BA11 

***** pi******** 

• REPLACE 


*** 

♦♦Gl* ♦*♦♦♦♦♦♦♦ 

G3* *». 

G4 * *♦. 



white • 

. ♦ ♦. 

. ♦ ♦ . 



ON ♦ 

.♦ ♦. YES 

.♦ FOLLOWED ♦. YES 



BACKING ♦ 

♦ . PERIOD . • 

>♦. BY. PERIOD .* 

>♦ 


STORE ♦ 

* 

♦. .* 

♦ . . • 

♦ . . ♦ 

♦. . ♦ 


*** 


♦. • ♦ 

♦. . ♦ 



♦ ♦♦^•♦♦♦♦♦♦♦♦* 

REPLACE ♦ 

BY ♦ 

COLON • 


i f< 


NEXT 

RECORD 

ALREADY 


ADJUST 
TEXT 
IN CORE 


,* FOLLOWED ♦. NO 

BY A .♦ 

♦. PERIOD .♦ 


*•** 

* * 

->♦ A2 ♦ 
* * 

***♦ 

♦♦••H 5* ♦♦♦••♦♦♦* 
* 

IGNORE ♦ 


*♦♦* 

->♦ A2 ♦ 
* < 
**** 


•J3***** 

IGNORE 


♦ YES 

L **** 
♦Cl ♦ 
>* A1 ♦ 


*♦*♦ 

♦ ♦ 

♦ A2 ♦ 

♦ ♦ 
***♦ 


.♦ FOLLOWED 
. BY A 
♦ . DIGIT 


****K4********* 

IGNORE 


REPLACE 

BY 

SEMI-COLON 


• **♦ 

• * 

>♦ A2 ♦ 

* * 

**** 
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Chart Cl. Phase Cl Overall Logic Diagram 


CONTROL IS PASSED DIRECTLY FROM PHASE AA IF 
MS -CHARACTER SET OR COMPILE-TIME PROCESSOR 
IS NOT SPECIFIED 


*•** 


POPLST 

B1 *. «****B2»*«»»*»*** 

.♦ TEST *. * INSERT LABELS * 

.FOR LABEL OR*. YES * AND/OR PREFIX * 

. PREFIX .♦ >* OPTIONS IN * 

♦, OPTIONS .* • DICTIONARY * 


. * 


PROC, ENTRY, * . DO, BEGIN 
Cl *. 

. * TEST * . 

.♦ FOR BLOCK ♦ . YES 

♦. HEADING . ♦ 

• . STATEMENT . * 


#. 


. # 


♦****C2* *♦♦****• 

* INCREASE 

* BLOCK AND/OR 
>* LEVEL COUNT 


**************** 


**** 

* * 

>♦ E2 * 

* * 
♦ ♦** 


.* TEST 
. FOR 

♦ . KEYWORD 


*. 


• ♦ . END 

D2 *. ♦ ♦♦♦♦^♦♦♦•♦♦♦♦♦* 

♦ . * DECREASE * 

TEST ♦ . YES ♦ BLOCK AND/OR « 

FOR .♦ >♦ LEVEL COUNT. * 

•END* . * * TRANSFER'END* < 

♦TO OUTPUT TEXT * 


. * TEST ♦ 
► IF LEVEL 
COUNT IS 
► . ZERO 


.♦ TEST ♦. 

.♦FOR NULL OR*. YES 

►. ASSIGNMENT .* 

♦.STATEMENT.* 


* SKIP 
r — ♦ TO NEXT 
I ♦ SEMI-COLON 


*. . * 

* NC 

♦ « 

• E2 *->| 

♦ * 

*♦♦* 

STAT2 

*****£ 2 ********** 


* TRANSFER 
>* STATEMENT TO 

* OUTPUT TEXT 


**** 

* * * 

* >♦ B1 ♦ 

* A * * 

***♦ 


. lEo 

I 


♦ CL ♦ 

• B2* 
* * 


*****F4****** 
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Chart CL. Phase CL .Overall Logic Diagram 


♦♦♦♦ 

» , 

* B2 * 

• 4 

• ••• 


PROC, ENTRY, 

BEGIN, I TOO, 

DO. GOTO. WAIT. 
DELAY, EXIT, STOP, 
ENDO, ENDITOO, 
RETURN. FREE. CALL, 
DISPLAY, FORMAT, 

END 


TEST FOR I 

GET, PUT, 

READ. WRITE, 
REWRITE. DELETE. 
OPEN, CLOSE, 
LOCATE, IGNORE, 
UNLOCK 


TEST FOR: 

ALLOCATE. DECLARE, 
ON. SIGNAL, 

REVERT, ASSIGN. 
GOOD, IF, PROCl 


. » TEST • 
. FOR SPECIFIC 
♦.KEYWORDS .♦ 



«*B3******+++ 



PROCESS 



THE 



STATEMENT 






i ♦♦♦♦ 


* 

* 


<•->♦ F2 

♦ 


MARK THE 
I/O PHASES 
AS 'WANTED* 


«**** 03 » *••***«** 


. * TEST *. 
. FOR OTHER . 
♦STATEMENTS. ♦ 


STATEMENT TO 
OUTPUT TEXT 
WITHOUT 
CHECKING 


.* TEST FOR 
END OF 
*. PROGRAM 


DOES NOT CONTAIN A ULCLAKL, 
CALL, OR ALLOCATE STATEMENT 


♦ ♦♦♦ 

♦ ♦ 

♦ F2 •-> 


♦CO • 
• BX* 


♦♦♦♦♦F2* ***••♦*•* 

♦ * 

• SKIP TEXT TO * 

• SEMI-COLON OR ♦- 
♦KEYWORD 'ELSE' • 

• * 
♦*♦•♦♦••*••♦•*♦** 


TEST 

FOR 

'ELSE* 


TRANSFER 
SE STATEML 
OUTPUT TEXT 


♦ ♦♦♦ 

* 4 

* B2 * 

* * 
♦ ♦♦♦ 
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Chart CO- Phase CO Overall Logic Diagram 


1 ->*: fob : 

«. DECUKE .« 

• * * MO 


>*. UBElts: 


* El • 

• • 

**** 


.♦ TEST *. 
FOB 

* . ALLOCATE .« 


TEST 

FOB 

CALL 


ECDL 

*»»*»C2***»»»**** 

* CHICK SYNTAX * 



DECLABATXON * >* B1 

OB * 

ALLOCATION * 


PBCCESS 

CALL 

STATEMENT 


El ♦ 

,* 

. * TEST 


SCANT 

***—E2*****»»** 

* TEAMS FEB 

* STATEMENT 
>* TO OUTPUT 

• TEXT WITHOUT 

♦ PROCESSING 


• YES 

1 ** 4 * 

♦CS * 

->• B2 * 
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Chart CS. Phase CS Overall Logic Diagram 


INPUT FROM PHASE CL IF PROGRAM 


READ, WRITE, 

GET, PUT. 

OPEN. CLOSE. 
REWRITE, DELETE, 
LOCATE, IGNORE, 
UNLOCK 


.* TEST FOR 
► . END OF 
*. PROGRAM 


. NO * TRANSFER * 

.♦ >* STAfSSMENT TO ♦ ' 

♦ OUTPUT TEXT • 


♦ YES 

I ♦ 

I *CV * 
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Chart CV. Phase CV Overall Logic Diagram 


► TEST ♦. YES 

FOR . ♦ 

►. LABEL(S) .♦ 


♦♦•*B3*^******* 


NO . ♦ TEST ♦. YES 

* . FOR PREFIX . • 

♦ . OPTIONS .♦ 


'♦♦*C3* ♦♦♦*♦♦♦♦ 

PROCESS 

PREFIX 

OPTIONS 


OC.UXR, V. 

DECLARE 


r 

. *, 

D2 ♦ . 

. * TEST * . 

* FOR CHECK ♦ . YES 

AND NOCHECK .♦ 

♦ . LISTS .♦ 


NO 


E2 

* 

TEST 

* . 

*, , 

* NO 


•♦D3******* 

FORM THE 
NECESSARY 
PSEUDO 
STATEMENT 


. * 


F2 ♦ . 

.♦ TEST ♦. 
.♦ FOR AN * 
♦.ON-STATEMENT 


CHEKON 

«****F3* ********* 

♦ SURROUND ♦ 

♦ THE ON-UNIT ♦ 


CHAIN 

*****£4********* 

♦ SLOT THESE 

♦ STATEMENTS 

— >♦ INTO THE 

♦ RELEVANT 

♦ CHAINS 


♦***G3*^*^***** 


TEST 

FOR 

•END* 


. * TEST 
♦. FOR END OF 
♦. PROGRAM . 


**** 

* * 

♦ B2 ♦ 

* « 
*♦** 


♦ *** 

* * 

♦ J2 ♦-> 

♦ * 

**** 

TRTSC \ 

♦****J2* ******** 


♦EG * 
♦ Al* 


**** 

* * 

>• £2 ♦ 

♦ ♦ 

**** 


110 



Table BX. Phase BX 48-Character Set Preprocessor 


| | Main Processing! 

I Statement or Operation Type j Routine | Subroutines Used j 

(Translates keyword table to {bA 00 |None | 

j internal code and initializes II I 

| Reads a record |BA1 | ZURD (AA) ] 

j Scans text | BA1A j None | 

{Handles operators and keywords |BA5 |None j 

{Replaces operator keywords j BA11 |None j 

{Replaces comma-dot by semi-colon jBA20 | None | 

{where applicable j j j 

Deals with quote marks |BA25 |None j 

»• + + ^ 

(Maintains parenthesis level count |BA30 |None | 

{Replaces period-period by colon j BA40 |None j 

{processes a slash {BA50 | None j 

{Reads one record ahead in case of {bA 70 |None { 

j need I I I 

{Restores the situation when a read |BA80 |None j 

{ahead has taken place | j j 

[puts out converted text and |BA90 | ZUBW | 

(original text onto backing store j j j 
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Table CA. Module CA Read-In Common Block 1 


r — — 

1 

Function 

1 

Subroutines 

~i 

_____ J 

r 

( Provides 
j passes of 

L 

subroutines common 
the read- in phase 

to all five (ACONST, 

(MVCHAR, 

DECINT, EXP, EXPAND, EXPLST, 
OPTOR, SCONST, SINGLE, SQUID 

IDENT, | 

J 


Table CA1. Module CA Routine/Subroutine Directory 


j Routine/Subroutine j Function j 

j ACONST j Checks for a valid arithmetic constant. | 

I I I 

|DECINT | Checks decimal integer. | 

j EXP (Diagnoses expressions. j 

I I I 

| EXPAND | Expands iterations of string constants and picture characters. | 

I I I 

{ EXPLST (Checks for a list of expressions separated by commas but enclosed inj 

j (parentheses. | 

I I I 

| IDENT (Checks for a valid identifier. J 

( I I 

(MVCHAR (Moves text from one address to another. | 

I I I 

j OPTOR | Checks for an operator and replaces the two-byte operators by | 

j j one- byte codes. j 

I I I 

| SCONST | Checks for a valid string constant. | 

I I i 

| SINGLE (Diagnoses a single expression in parentheses. | 

I I I 

j SQUID (Checks for a valid subscripted and qualified identifier. | 
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Table CC. Module CC Read- In Common Block 2 

| Function | Subroutines | 

j Provides subroutines common to all five j CHAR, CHECK, KEYWD, MESAGE, NONEX, | 

| passes of the read- in phase |NULINS, OPTEST, PICT, PREC, SOFLOW | 


| Routine/ Subroutine | 


Table CC1. Module CC Routine/Subroutine Directory 

Function 

(Diagnoses the CHARACTER and BIT data attributes, 
j Tests the top entry in the stack. 


1 - 

| CHAR 




| CHECK 
KEYWD 

| MESAGE 
| NONEX 
| NULINS 

I 

| OPTEST 

I 

| PICT 
PREC 


| SOFLOW 
L 


H 


Identifies keywords and hands back the replacement character to the 
caller. 

Provides a diagnostic message. 

| Checks stack for non- executable statements. 

Inserts null statement in output text. 

(Tests the output string and moves text to the output. 

(Diagnoses a picture. It uses a TRT table set up for the purpose. 

(Diagnoses the precision, and the attributes and format items which 
(use it. 

(Bumps stack pointer and checks for stack overflow. 


Table CE. Modules CE, CK, CN, and CR Read- In Keyword Block 

| Function | Subroutines | 

j Provides tables of keywords in internal |None j 

jcode, together with replacement code. j j 

j No functional code exists in these modules. j j 

j Refer to Appendix B for details of keyword | j 

[tables. j | 
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Table Cl, Phase Cl Read- In First Pass 


j | Main Processing! j 

j Statement or Operation Type j Routine j Subroutines Used j 


Controls main scan, identifies | 
statements, and analyzes some in j 
detail 


RSTART 


| ASSIGN, BADST1, BEGIN, DO, 
j ELSE, BUMP, END, EOP, ERROR, IF, 
j ON, POPLST , PROC, READ, SIGRVT, 

I STAT2 , STRING, plus those 
| subroutines contained in modules CA 
j and CC 


Table CI1. Phase Cl Routine/Subroutine Directory 


| Routine/Subroutine j Function 


I ASSIGN (CG) 


| BADST1 


I BEGIN (CG) 


DO (CG) 


t ELSE (CG) 


END (CG) 


I ENTRY 


| ERROR (CG) 
I IF (CG) 


ION (CG) 


I POPLST 


I RSTART 


I SIGRVT (CG) 


Diagnoses an assignment statement. 

Recovers from failure to recognize a statement type; skips to next 
semi-colon . 

Checks the BEGIN statement and makes an entry in the first pass 
stack. 

Advances the input Data Pointer (DP) , skips blanks, if any, forcing 
source text to be read into storage as necessary. 

Checks the DO statements and makes an entry in the first pass stack. 
Unstacks an IF compound statement. 

Processes three different types of END statements; PROCEDURE-BEGIN; 
DO; iterative DO. 

Processes ENTRY statement. 

Processes end- of -program marker, and returns to compiler control in 
order to load next pass. 

Handles false starts on possible statements. 

Scans the IF statement and makes entry in first pass stack. 

Diagnoses the ON statement and makes entry in first pass stack. 

Removes prefix options from the text and places them in the 
dictionary. 

Scans the PROCEDURE and ENTRY statement and makes an entry in the 
first pass stack. 

Reads source text into storage, translating it into internal code, 
except for character strings; removes comments; prints source 
listing and prefix options. 

Controls the first pass scan. Enters statement labels into the 
dictionary. 

Scans SIGNAL and REVERT statements. 


STAT2 (CG) 


| Handles all other statements. 

I 

I Statement identifier routine. 


j STRING (CG) 


j Scans character strings, 



Table CL. Phase CL Read-In Second Pass 


I 


Statement, or Operation Type 


| Scans for statements handled in |SCNA 
| this pass, analyzing them in j 

(detail. Skips over other statements! 

I I 


| Main Processing! 
j Routine j 

4 f- 


Subroutines Used 


(BUMP, DELAY, DSPLAY, DO, FREE, 
(GOTO, ITDO, LABEL, PROC, RETURN, 
j TRTSC , plus those subroutines 
j contained in modules CA and CC 




Table CL1. Phase CL Routine/Subroutine Directory 
| Routine/Subroutine | 


| BUMP 


| DELAY 


| DSPLAY 


| DO 


| EOP 


| FREE 


| GOTO 


| ITDO 


! LABEL 


| OPTION 


|PROC (CM) 


| RETURN 


| SCNA 


| TRTSC 



Function | 

Increments the input Data Pointer (DP), skipping over blanks, 
obtaining a new text block if necessary. 

Processes DELAY statements. 

Processes DISPLAY statements. 

Processes DO statements. 

Processes end- of -program marker, and releases control to phase CO or 
CS, or CV (CO and CS are optional phases). 

Processes FREE statements. 

Processes GOTO statements. 

Processes iterative DO statements. 

Diagnoses LABEL attributes. 

Bandies OPTIONS attribute on PROCEDURE or ENTRY statements. 

Analyzes PROCEDURE attributes and options, and completes the 
diagnosis of PROCEDURE and ENTRY statements. 

Processes RETURN statements. 

Main controlling routine of this pass. 

Skips over all other statements. 


—j 
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Table CO. Phase CO Read-In Third Pass 


r 

I 

| Statement or Operation Type 

K 

{Scans for DECLARE , CALL, and 
| ALLOCATE statements. Analyzes 
j syntax of attributes by calling 
japoropriate subroutines 

I 

L 


(Main Processing! 

j Routine { Subroutines used 

+ + ^ 

{ SCAN2 j ATTLST, BUMP, CALLOP, DECL, DEFIND, j 

j | DIMS, ENTRY, ENVMNT, EOP, | 

j j GENRIC, LABEL, LIKE, USES, IVLIST, | 

| land those subroutines contained in | 

j j modules CA and CC | 

x j j 


Table COl . Phase CO Routine/Subroutine Directory 

r T 1 

| Routine/Subroutine | Function | 


J. 

— 


H 

| ATTLST 


(Processes an attribute list. (Recursive) 


| BDCL 


1 

(Processes DECLARE or ALLOCATE statement. 


| BUMP 


i 

| Advances Data Pointer (DP), obtaining new input block if necessary. 

i 


| CALLOP 

(CP) 

1 

{Checks CALL statements and options. 

1 


| DECL 


1 

{Processes the DECLARE and ALLOCATE statements. 


j DEFIND 


1 

(checks the DEFINED attribute. 


| DINS 


I 

{Examines the dimension specifications. 

1 


| ENTRY 


1 

{Checks the ENTRY attribute. 


| ENVMNT 

(CP) 

{Removes environment information from the text and inserts it into 




jthe dictionary, 
j 


j FOP 


{Processes the end- of -prog ram marker, and releases control. 


| GENRIC 


{Processes the GENERIC attribute. 

1 


1 IVLIST 

(CP) 

1 

{Processes the INITIAL attribute. 


| LA EEL 

(CP) 

! 

{Analyzes LABEL attribute. 


{LIKE 


1 

{Processes the LIKE attribute. 


) PSQUID 

(CP) 

|Checks for a qualified subscripted identifier in parenthesis. 

1 


j REFER 

(CP) 

1 

{Checks the REFER attribute. 

i 

j SCAN 2 


{Scans for DECLARE, CALL, or ALLOCATE statements, moves others to the| 



{output string unaltered. 


j SCANT 


| 

{Moves text to semicolon without alteration. 


I USES 

L 


{Deletes the now obsolete USES and SETS attributes from text. 

i 
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Table CS. Phase CS Read-In Fourth Pass 


r T r 1 

| j Main Processing! | 

j Statement or Operation Type j Routine | Subroutines Used | 


t + + ^ 

|Controls main scan and identifies (SCNA |EOP, FORMAT, GET, LIST, OPEN, | 
j I/O statements for further analysis! j READ , TRTSC, plus those subroutines! 
| j J contained in modules CA and CC j 


L. 


.± 




J 


Table CS1. Phase CS routine /Subroutine Directory 

r T n 

|Routine/Subroutine J Function | 


y + ^ 

I I I 

JEOP | Processes end-of-program marker and releases control. | 

j FORMAT (CT) j Processes the FORMAT statement and format lists. j 

I I I 

J GET (CT) (Processes GET and PUT statements. | 

I I I 

J LIST J Processes data lists. | 

I I I 

| OPEN (CT) (Diagnoses OPEN and CLOSE statements. | 

I I I 

(READ (Checks the syntax of RECORD I/O statements READ, WRITE, REWRITE, and| 

| j DELETE. This routine also checks for permissible combinations of j 

j (these statements. j 

I t I 

JSCNA (Main scan of this pass. | 

I I I 

(TRTSC | Skips over all statements other than I/O, moving them to the output | 

j j text . ( 

L -L J 
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Table CV. Phase CV Read-In Fifth Pass 


r t —r 1 

| | Main Processing! | 

| Statement or Operation Type j Routine j Subroutines Used 1 

I- + + ! 

j Identifies statements for which it |SCNA | CALLIN, CHAIN, DECL3, D03, END3, | 

| must build chains j j ENTRY3, EOP, POA1, PR0C3 , TRTSC , | 

j j j and those subroutines contained in | 

| j j modules CA and CC. | 

L X L J 


Table CV1. Phase CV Routine/Subroutine Directory 

r t 1 

| Routine/Subroutine | Function | 

I- + 1 


ICALLiN CCW) 

(Makes up the CALL chain. 

1 



| CHAIN 

1 

(Forms chains. 

1 



jCHfc'CKON 

i 

(Checks the fifth pass stack for ON entry, in order to insert 



(PROC-END statements round the ON unit. 



| DECL3 

1 

| Chains the DECLARE statement to the appropriate PROC or 

BEGIN 



( statement. 

1 



IDO 3 

1 

| Makes a stack entry for DO block. 



1ENA3 

1 

| Checks the fifth pass stack. 



! 

j ENTRY 3 

I 

| Makes an entry in the ENTRY chain. 

1 



! EOP (CW) 

I 

J Processes end- of- program marker, and releases control, 
j 



JILfcBSN (CW) 

j Creates pseudo-assignment statements for initial labels. 
1 



j POAl 

1 

(Analyzes prefix options in greater detail. 



| POC1 

1 

(Processes check lists. 

1 



| PR0C3 

1 

(Makes an entry in the PROCEDURE-BF.GIN chain. 



| SCMA 

1 

(Main controllino routine of the pass. 

| 



| SCNZ 

(Extracts statement number for label entry. 

| 



| TRTSC 

J Skips over statements not required for analysis in this 
! 

phase. 
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Chart 03. Dictionary Loqical Phase Flowchart 


•-*-•-•-*-•-*-♦-♦ 
•SET UP HASH TAB* 
** INSERT TABLE * 
•ENTRIES Itl CHNS* 


•••••Bl********** 

•CREATE DICT ENT* 

• TOR PROC. BEGIN* 
•AND ENTRY STMNT* 
♦AND SETUP ENTRY* 

• TYPE I CHAINS • 




•SCAN DECL CHAIN* 
♦PREPARE ATTRIBS* 
•FOR NEXT PHASE * 


•-♦-*-*-*-*-*-*-♦ 
•SCAN DECL CHAIN* 
•MAKE ENTRY TOR • 
•EACH DEC VARIAB* 


♦SET LATE PHASES* 
•WANTED OR UNWTD* 
• ACC TO FLAGS * 


•**»*P1»**«»*«**» 
♦SCAN ENT TYPE 1* 
•CHN MAKING ENT * 
•TYPE 2 t 3 DICT* 
« ENTS FOR DATA • 
•TYP RET BY PROC* 
«****»**•**•***•• 


•***«G1*** ******* 

* SCAN CALL ♦ 

* CHAIN MAKING * 
•DIC ENTRIES FOR* 

* EXTERNAL ENTRY ♦ 

* NAMES * 


HI *. 

. * DOES * . 

.« PROGRAM *. 
•.CONTAIN LIKE . 
♦.ATTRIBUTE.* 
*. . * 

♦ . . * 


•BCD-DICT REF FE 


->*SCAN LIKE CHAIN* 
* EXPAND ALL * 
•LIKENED STRUCTS* 


■ •ALLOCATE OR*. YES 

♦PTR. QUALIFIER.* 

♦IN PROGRAM.* 


->*COPY DICT ENTRY* 
•OF ALLOCD t PTR* 
•JUALFD VARIAB LS* 


-•-♦-«-*-•-♦ 
•SCAN TEXT. MAKE*- 
♦ENTRY FOR COND ♦ 

• NAMES t FILES * 


•»*.*K2* ********* 

• MAKE DICT • 

• ENTRIES FOR * 
-> *CONST ANTS USED •- 

♦IN THE PROGRAM * 


->• CHANGE BCD TO 

• DICTIONARY 

• REFERENCES 


•CHECK VALIDITY 

* OF DICTIONARY 

• REFERENCES 


.* SETS ». 
.» OR USES » 
♦.ATTRIBUTE IN 
*. PROGRAM .* 


•ATTRIBUTES FK* 
»-»-•-*-»-•-*-•-» 

->*PROCESS SETS t ♦ 
* USES LISTS IN • 
•THE DICTIONARY * 


♦CONSTRUCT DICT ♦ 

• ENTRIES FOR • 

* ON-CONDITIONS * 


*»***E3** ******** 

* REPLACE BY AN * 
•ERROR STATEMENT* 

* ANY STATEMENT * 
•CONTNG A DUMMY » 
♦DICT REFERENCE ♦ 


. ♦ ANY * 
PICTURES 
IN THE 
. PROGRAM 


->*CHECK VALIDITY ♦ 

* OF PICTURE ♦ 

* CHAIN * 


•CHAIN VARIABLES* 
•OF EACH STORAGE* 
♦CLASS t CONSTS • 


*.***U3** •***•••• 

• UNCOMMON * 

• PICTURE AND * 
•DIMENSION TABLE* 

• DICT. ENTRIES ♦ 


****»j3»«»***.*.* 

• 2ND FILKRGB FV* 

•AFTER ALLOCATE •- 

• PROC OR BEGIN * 

• STATEMENTS • 


->• 


•****J4* *•**•*••• 

* PROCESS ♦ 
ADJUSTABLE ♦ 
EXTENTS ON • 
•BASED VARIABLES* 


t 

. * . 

KJ *. 
.* ATR * 
. * OR XKEF 
. LISTING 
♦.REQUIRED 


• . 


PRINT ATR 
AND/OR XREF 
LISTING 


• NO 

I **.* 
•04 » 
->• Bl 


*04 » 

->* Bl 
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Chart EG. 


Phase EG Overall Logic Diagram 


♦****A1** 44**44* 


CAA1 V 

*** **B1* ******** * 

* INSERT LABELS * 
•IN HASH CHAINS, • 

♦ CHECKING FOR • 

• MULTIPLE * 

* DEFINITION • 



MOVE 

SUBROUTINES 
INTO SCRATCH 
CORE 


4*44*C144* *44**4 

* SCAN 

* PROC-BEGIN 

* CHAIN 

4444*44444444444 

*444 

* * 

• D1 *-> 

* * 

**** 

. * . 

D1 • 

• *. PROC 


**«* 

♦ * 

* D2 ♦ 

♦ * 
* •* * 


CFORP 

44 44 4Q3* 4 444 4 4 444 

* SCAN FORMAL * 
•PARAMETER LIST • 

>* AND CREATE *- 

* F.P. TYPE 1 • 

* ENTRIES ♦ 


••♦*E3********* 


CTYPBL 

44 44 * 044 4**4 4 4444 

•SCAN ATTRIBUTE ♦ 

• LIST. CREATE • 

>• ENTRY TYPE 2 •- 

* FOR THE ♦ 
♦STATEMENT LABEL* 


•**D5** *•••• 

CHAIN 
VARIOUS 
ENTRY DICT 
ENTRIES 


'•••E5******** 
UPDATE 
MAFSTACK IN 
SCRATCH 
STORAGE 


444* 

*EI ♦ 

->* A2 



* 

TYPW V 

NOTE: 

4+444F3*** *••*••• 

44444P54444444444 

GOES TO PHASE EP 

♦ UPDATE * 

* SCAN • 

IF THERE ARE NO 

* MAPS TACK ♦ 

* ENTRY CHAIN ♦ 

DECLARE STATEMENTS 

4 4 

4 4 

4 4 

4 4 


-4 

•••• 

* D1 * 

4 4 
4444 


*444 
4 « 

* D2 « 

4 * 

4444 
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Chart El. Phase El Overall Logic Diagram 


CHARACTER, BIT. PICTURE, 
USES. SETS. DEPINED, 

position. Like. 

DIMENSIONS, INITIAL, 
INITIAL CALL. LABEL, 
PRECISION, OFFSET, 

BASED, AREA 


** + * 

» * 
• B3 * 
» * 
*** t 


CCGSE 

+*+*+B2******»*< 

• PICK UP 

* NEXT ENTRY 

• IN OECLARE 

♦ CHAIN 


>*»#B3********* 

CONTINUE 
SCAN OF 
DECLARATION 


CCFLP.CCFRP 


. • TEST *. 

.♦ FOR ♦ . YES 

. FACTORED . ♦ 

♦ATTRIBUTES. * 


->• 


***&*C3* 

REPLACE ♦ 
PARENTHESES ♦ 

BY SPECIAL ♦ 

CODES FOR ♦ 

LATER PHASES ♦ 


E2 ♦. 
.♦ TEST ♦ 
► FOR 
ENTRY OR 
►. GENERIC 
♦• . ♦ 


••♦♦*D3******** 

♦ PARTIALLY 

♦ PROCESS THE 
->• ATTRIBUTE TO 

♦ ASSIST LATER 

♦ PHASES 


GENTRY 

*•***£ 3 * ********* 

♦ KEEP A COUNT ♦ 

• OF THE ♦ 

>♦ PARENTHESES TO ♦- 

♦ASSIST FACTORED* 
♦ATTRIBUTE SCAN ♦ 


* TEST ♦. •••• 

FOR ♦. NO * ♦ 

END OF .♦ >• B3 • 

DECLARE .♦ ♦ ♦ 


♦ . 


CSGSOO .♦. 

! G2 

. * TEST 

! NO .♦ FOR END 

*. OF DECLARE 

*. CHAIN 


• YES 

I *#*# 
♦EL ♦ 
l ->* A1 
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Chart EL. Phase EL Overall Logic Diagram 


INITIALIZE 
PASS CONTROL 
TO IEMEM 


SCAN CHAIN 
->♦ OF PROCEDURE 
STATEMENTS 


* El • 

t « 


Cl « 

.* 

► END 
OF CHAIN 

» . 




* SCAN CHAIN 
>« CF DECLARE 

• STATEMENTS 


*. . * 

* YES 
I **»» 

1 *EF * 
t->» A1 
* * 
**♦* 


♦ END CF * 
DECLARATION 
*. LIST .♦ 


CDCLSC 

♦*«*•** 

* FICK UP NEXT 

* IDENTIFIER 
>*IN DECLARATION 

* LIST 


DECIDE 
NATURE OF 
IDENTIFIER 


ATLSCN 

*•*•**•• 

APF1Y 

ATTRIBUTES IN 
ATTRIBUTE 
LIST 


*****G3****** 

* APPLY 

* FACTORED 

* ATTRIBUTES 


**«U3****»*«* 

APPLY 
IMPLICIT 
AND DEFAULT 
ATTRIBUTES 


CDICEN V 

•****J3****«*« 

* MAKE 

* DICTIONARY 
* ENTRY FOR 

* IDENTIFIER 


***» 

->» B1 * 
• • 
»*«» 
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Chart EP. Phase EP Overall Logic Diagram 


♦♦♦♦♦Al»*»»»»«»«* 

• CONDITIONALLY 

• KARK PHASES 
« WANTED AND 

• NOT WANTED 


EPL20 V 

♦•♦♦•Bl •♦♦♦♦•♦•• 

* GO TO 

♦ FIRST ENTRY 

• IN 

♦ ENTRY TYPE 1 

« CHAIN 


GO TO DICT 
ENTRY FOR 
FIRST LABEL 


EPL75 <1 

♦ CONSTRUCT 

♦ ENTRIES 
>♦ TYPE 2 AND 

♦ 3 IF NOT 

♦ THERE 


tPLIOU 


GC TC LICT 
ENTRY FOR 
NEXT LABEL 


EPLUO V 

•««**C2******** 

• GO TO NEXT 

• ENTRY IN 

• PROCEDURE 

• ENTRY CRAIN 


C3 ♦. 

. ♦ *. 

PROCEDURE 


YES • ♦ 

.« >» B2 • 


♦**D1*****»*» 
GET TEXT 
REFERENCE 
OF START OF 
CALL CHAIN 


**»* 

• • 

• El •-> 

• * 

♦ »•» 

El * 


DS *. 

->•! FRCCLCURE 


END 

OF CALL 
CHAIN 


**««»E2**»****** 

* SCAN THE 

* DICTIONARY 
>« FOR THE 

* IDENTIFIER 


E3 •. 

* 

KNOWN 


YES 

**•* 

♦ EW * 
->* A1 


CONTROL PASSED TO 
PHASE EW (OPTIONAL) OR 
PHASE EY (OPTIONAL) OR 
PHASE FA (NON-OPTIONAL) 


CALL 

VALID 


EPL360 

♦♦♦♦♦G3‘ ♦♦•♦♦♦♦♦♦ 

♦ REPLACE ♦ 

♦ BCD BY • 

♦ DICTIONARY *- 

» REFERENCE * 


. ‘IDENTIFIER 
. BUILT-IN 
♦ .FUNCTION . 


GENERATE 
ERROR 
MESSAGE 
INSERT DUMMY 
REFERENCE 


♦ REFERENCE 

>♦ OF NEXT 

♦ ITEM IN 

♦ CALL CHAIN 


CDICEN 

♦♦♦♦♦£$♦♦♦♦♦♦♦♦•• 

♦MAKE DICTIONARY* 

* ENTRY USING • 
>• DEFAULT SULL3 * 

• FOR DATA TYFF • 


EPL360 

•» *» *fS** »♦•♦♦ * 

REPLACE 
BCD BY 
DICTIONARY 
REFERENCE 
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Chart EW. Phase EW Overall Logic Diagram 


EWBKGN 

*»***A1 ********** 

♦ INITIALIZE. * 

♦ GET SCRATCH * 

♦ STORAGE AND ♦ 

♦ FIRST ITEM IN ♦ 

♦ LIKE CHAIN » 


»*•* 

* * 

* B1 ♦-> 

* • 

«••* 

FWSTRT 

*****B1*** ****** 

* SAVE ADDRESS 

* CODE BYTES 

* LEVEL ETC 


♦SCAN DICTIONARY* 

* FOR STRUCTURE ♦ 

* WITH SAME BCD * 


*****C2********* 


► THIS A «. 
VALID 

►.STRUCTURE.* 


*****Q3********* 

* PICK UP 

* STRUCTURE 
->♦ KITH THE LIKE 

* ATTRIBUTE 


.♦ ORIGINAL *. NO 

— >♦. STRUCTURE .* 

♦ . DIMENS- . * 
♦.IONED.* 


EWORDM .*. 

E2 *. 
.♦IS THIS*. 

. * ELEMENT < 
>*. DIMENSIONED 


*, 


. * 


•COPY STRUCTURE 
->* ELEMENT INTO 
» SCRATCH 


. » THIS A *. 
->♦. MAJOR 

♦.STRUCT URE. * 


*••**£ !)»**•**•*•* 

* SET UP • 
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Chart EY. Phase EY Overall Logic Diagram 
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Chart FA. Phase FA Overall Logic Diagram 
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Chart FI. Phase FI overall Logic Diagram 
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Chart FK. Phase FK Overall Logic Diagram 
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Chart FO. 


Phase FO Overall Logic Diagram 
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J 
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Chart FX. 


Phase FX Overall Logic Diagram 


♦♦♦♦*A2********* 

* LOAD IEMFY. 

* GET SCRATCH 

* STORAGE AND 
♦TEXT BLOCK FOR 

* SORT TABLE 


> •flillUDUlL. nu * 

->* COMPILER LABEL. ♦ >♦ 

ON CONDITION* ♦ 

♦ . NAME . ♦ ♦ 


SOFT ENTRY 


END 

OF 

CHAIN 


4444 
* * 

► E2 *-> 


*444 
FX0170 

4 ♦♦**•**** 


***************** 



* 44 * 

► 4 

► G2 * — i 


••1 


4444 

FXPRNT 

* 4 44 4(32*** **** * * * 


YES 

D5 ’ 

* * . 
END 
OF 

CHAIN . 
NO 


.♦ALLOCATION *. NO 

->♦. OR .* 

♦.PARAMETER.* 


44***FU* *♦♦♦♦♦♦♦♦ 
♦ * 
4 * 

->♦ SORT ENTRY ♦ 


! CONDITION 
•ENTRY^TYPE. 


-♦ SORT ENTRY 


L->* E2 ♦ 

♦ ♦ 
* 44 * 

XBCD 

44 * 63*4444444444 

♦ PRINT BCD ♦ 
-> AND DCL NO. 

* (IF ANY) * 

444444444444444 * 


44444JJ2*** ******* 
♦ ADD STATEMENT * 
*. YES * NUMBER TO CHAIN* 

.* >4 FOR THIS DICT • 

* * ENTRY * 


. 1 .* 


ATTR 

LISTING 

REQD 


» >* . 


»**j 3* »«*•*»*»«» 


* itnui x r iixn 

* IS BASED, TO 
-•CHAIN FOR DICT 

* ENTRY OF 

* POINTER 


XREF 

LISTING 

REQD 


.« >». 


SCAN CHAIN OF 
• STATEMENT 
NUMBERS AND 
PRINT THEM » 


END OF 
SORT 
CHAIN 


♦ YES 
I »•»• 
•GA « 
l->» A1 
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Table ED. Phase ED f Initialization 


1 

Statement or Operation Type | 

|Main Processing! 

| Routine j Subroutines Used 

Sets up routines in scratch storage j 
for phase EL j 

| SETUP j 

1 1 

None 


Table EDI. Phase ED Routine/ Subroutine Directory 


j Routine/Subroutine j Function 

[event | 

j TASK | 

j CELL j Routines for processing declared attributes. These set up 

j BASED j information in the attribute collection area of scratch core, 

| POINTER jfor reference by CDICEN, etc., in phase EL. 

| OFFSET | 


1 


Table EG. Phase EG Dictionary Initialization 


| | Main Processing! | 

| Statement or Operation Type j Routine j Subroutines Used j 

['Hashes labels jcAAl |CHASH, CBCDL2 | 

[PROCEDURE-BEGIN chain |CA7 | None | 

[ BEGIN j CA8A 

None | 

\ PROCEDURE 

[entry 

| Formal parameters 

CAPROC 

L 

CANATP, CFORP | 

L • J 

CA10 j CAN ATP, CFORP j 

CFORP IcHASH, CBCDL2 | 

| Attribute list 

j Creates entry type 2 entries for 
| labels 

CANATP | CAPREl, CATCHA, CATBIT, CATPIC | 

CTYPBL 

ENT2F, CDEFAT \ 

J 
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• Table EG1. Phase EG Routine/Subroutine Directory 


| Routine/Subroutine | Function ] 


jCAAl 

(Scans label table and hashes labels. 

1 


| CANATP 

I 

| Processes 

■ 

attribute list. 


| CAPROC 

1 

| Processes 

■ 

PROCEDURE statements. 


| CAPRE1 

1 

| Processes 

■ 

precision data. 


| CATBIT 

1 

j Processes 

I 

BIT attribute. 


| CATCBA 

1 

| Processes 
■ 

CHARACTER attribute. 


| CATPIC 

1 

j Processes 

PICTURE attribute. 


|CA6 

1 

| Scans the 
j sets bits 

j PROCEDURE 

1 

PROCEDURE-BEGIN chain for the relevant statements, and 
in Dictionary entries for optimization options on 
and BEGIN statements. 


| CA8A 

1 

(Processes 

BEGIN statements. 


|CA10 

1 

| Processes 

ENTRY statements. 


| CBCDL2 

1 

| Traverses 
j that just 
| 

the hash chain looking for entries with the same BCD as 
found. 


| CDEFAT 

1 

| Completes 

■ 

data byte for entry type 2 entries by default rules. 


| CFORP 

1 

| Processes 

formal parameter lists. 


|CHASH 

| Obtains an address in the hash table for an identifier. 


j CTYPBL 

1 

| Creates entry type 2 entries for labels. 


| ENT2F 

1 

| Creates or copies second file statements. 


| TYPW 

1 

| Scans ENTRY chain. 


| OPTN1 (EF) 

(Checks containing block options, for inheritance. 

1 


|OPTN2 (EF) 

i 

( Processes 
1 

procedure options. 


| OPTN3 (EF) 

(Performs post processing, makes STATIC DSA decisions. 

1 


| ATTRBT (EF) 

i 

| Processes 

POINTER, OFFSET, and AREA attributes. 

i 
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Table El. Phase El Dictionary Declare Pass One 


r t r t 

| | Main Processing! | 

I Statement or Operation j Routine j Subroutines Used j 

»■ + + ! 

| Scans DECLARE statement JCCGSO (None | 

j. ■(■ j. -( 

| Scans text | CCGS2 | None | 

f + + 1 

(Processes structure level (CCGSCM (None | 

I- 4. + 1 

(Factored attribute, left (CCFLP (CFPMCR | 

j parenthesis j j j 

(Factored attribute, right (CCFR? |None | 

j parenthesis j j | 

(- + + ^ 

(Data following DEFINED attribute (CCDEF J NEWBLK, CTXTRM j 

^POSITION (POSIT | None | 

[CHARACTER, BIT (CHABIT | CTXTRM | 

|- + + A 

(PICTURE JCATPIC | None | 

I- + + ^ 

I LIKE | LIKE | None | 

I- + + 4 

(KEY (KEYED | None j 

l ■(■ (• -j 

(Dimension (CDDIMS (CTXTRM, AST, TOMENE, ERRORB J 

[precision |CDPREC |erRNEG, SCLBIG | 

j. 1 (■ a 

j INITIAL j EJINIT jCECON, EHINIT ( 

(. + (. 4 

| INITIAL CALL (INCALL (CTXTRM | 

[oFFSET joFFSET | CTXTRM | 

t + + A 

j EASED j BASED j PTVEXP | 

Y + + 1 

(AREA (AREA (CTXTRM j 
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Table Ell- Phase El Routine/Subroutine Directory 

r r 

| Routine/Subroutine | Function | 


| AREA | Processes AREA attributes. 

j AST j Deals with the case of* dimension bounds mixed with non -* bounds. 

I I 

| BASED (EH) | Entry point in OFFSET routine, at which second file statement is 

j j made . 

I I 

| CATPIC | Processes PICTURE attributes. 

I I 

| CCDEF | Processes data following DEFINED attribute. 

I t 

| CCFLP | Processes factored attributes (left parenthesis). 

I I 

| CCFRP | Processes factored attributes (right parenthesis). 

|CCGSCM | Processes structure level, 

j CCGSAT j Attribute routine selector. 

I I 

JCCGSE (Scans DECLARE chain. 

I I 

(CCGSOO | Scans text, 

j CCGS2 j Scans source text. 

I I 

| CDDIMS (EJ) (Processes dimension attributes. 

(CDPREC (EJ) (Processes precision attributes. 

(CECON (EH) j Makes a dictionary entry for a constant unless one has already been 

| {made. Returns the dictionary reference of the constant entry. 

| CFPMCR (Obtains more storage for the factored attribute table. 

1 I 

JCHABIT (Processes CHARACTER and BIT attributes. 

( I 

(CSGSOO (Detects end of DECLARE chain. 

(CTXTRM (Tests for space in current text block and obtains new block if 

j j necessary. 

| EH I NIT (EH) (Processes the INITIAL attribute except for the initialization of 

( | label variables and INITIAL CALL. 

(EJINIT (EJ) (Processes INITIAL attribute and LABEL with a label- constant list. 

| ERRNEG (Deals with the case of a negative precision specification. 

|ERRORB (Deals with the case of lower dimension bound declared greater than 

( (the upper bound. 


j 



Table Ell. Phase El Routine/Subroutine Directory (cont'd) 

Function 


r T . 

j Routine/Subroutine | 


— i 

I 

-H 


r 


T 

| GENTRY 



| INCALL 

(EJ) 


| IVROOM 

(EH) 


| IVPUTL 

(EH) 


| IVPUTC 

(EH) 


| IVPUTO 

(EH) 


| KEYED 



| LIKE 



| NEWBLK 



j OFFSET 

(EH) 


| POSIT 



| PTVEXP 

(EH) 


| SCLBIG 



| SECON 



| SETS 



| TOMENE 


JL 


Keeps a count of parentheses in GENERIC and ENTRY processing. 
Processes INITIAL CALL attributes . 

Checks if there is space in scratch storage for another entry. If 
not, it makes a dictionary entry and chains it to the previous one 
or to the C8 in text as required. 

Places a dictionary reference in the 'initial list' for a label 
constant. If the constant is not known, a dummy reference is 
inserted. 

Places a dictionary reference in tne 'initial list* for a constant. 

Places the dictionary reference of zero in the 'initial list' for a 
negative or imaginary replication factor. 

Processes KEY attributes. 

Processes LIKE attributes. 

Obtains new text block. 

Processes OFFSET attributes. 

Processes POSITION attributes. 

Entry point in OFFSET routine, at which secondfile statement is 
made. 

Deals with the case when a precision specification for fixed-point 
data is declared too large. 

Creates a dictionary entry for a constant provided the appropriate 
entry has not been already made. 

Processes USES and SETS attributes. 

Deals with the case when t*he number of dimensions declared is 
greater than 32. 


._j 
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Table EL. Phase EL Dictionary Declare Pass Two 


r t t 1 

| | Main Processing} j 

I Statement or Operation Type j Routine | Subroutines Used | 

F + + } 

| Scans chain of DECLARE statements | CGENSC | CDCLSC | 

| Scans each item Of DECLARE | CDCLSC |ATLSCN, BCDPR, CDFLT, CDICEN, \ 

j statement | (CDIMAT, DCIDPR, INTLZE, POSTPR, | 

j j j SELMSK , STRPR | 

j Initializes each identifier j INTLZE j DCIDPR | 

| declared j j j 

j Processes factor brackets and level j DCIDPR j temscn, BCDPR j 

j numbers j | j 

| Scans for next level number | TEMSCN jCDATPR j 

[processes BCD of identifier } BCDPR (BCDISB, CRASH, SELMSK j 

(Hashes BCD of identifier |CHASH |None | 

j Scans list of attributes following (ATLSCN jcDATPR | 

j identifier j j j 

|. + + ^ 

| Applies factored attributes JCDFATT |CDATPR | 

| Applies implicit attribute } IMP ATT | None | 

[Attributes controlling routine | CDATPR |CDAT40 f CDAT41, CDAT42, CDAT43 , | 


j j j CDAT44, CDAT45, CDAT48, CDAT49 , | 
j j j CDAT4A, CDAT4B, CDAT4C , CDAT4D, | 
| j j CDAT4F, CDAT54, CDAT55, CDAT56 , | 
j j j CDAT57 , CDAT58, CDAT59, CDAT60 , | 
| j j CDAT61, CDAT62, CDAT63, CDAT64, | 
j 1 j CDAT69, CDAT6A, CDATB4 , CDATB8 | 
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Table ELI. Phase EL Routine/Subroutine Directory 

| Routine/Subroutine | Function | 


| ATLSCN 

| BCDISB 

| BCDPR 


| Scans the 

1 

| Checks for 

1 

| Processes 

1 

list of attributes following the identifier. 

multiple declarations, etc. 

BCD of identifier. 


| CDATPR 

(EK) 

1 

| Attribute 

i 

controlling routine. 


1 CD AT 40 

(EK) 

1 

| Processes 

i 

DECIMAL attribute. 


|CDAT41 

(EK) 

| Processes 

i 

BINARY attribute. 


|CDAT42 

(EK) 

1 

| Processes 

i 

FLOAT attribute. 


|CDAT43 

(EK) 

(Processes 

1 

FIXED attribute. 


(CDAT44 

(EK) 

1 

| Processes 

i 

REAL attribute. 


| CD AT 4 5 

(EK) 

1 

| Processes 

i 

COMPLEX attribute. 


| CDAT46 

(EK) 

1 

| Processes 

i 

precision attributes. 


1 CD AT 4 8 

(EK) 

| Processes 

i 

VARYING attribute. 


| CD AT 4 9 

(EK) 

1 

| Processes 

■ 

PICTURE attribute. 


| CD AT 4 A 

(EK) 

1 

(Processes 

i 

BIT attribute. 


(CDAT4B 

(EK) 

1 

| Processes 

i 

CHARACTER attribute. 


|CDAT4C 

(EK) 

1 

| Processes 

i 

FIXED DIMENSIONS attribute. 


| CDAT4D 

(EK) 

1 

| Processes 

LABEL attribute. 


|CDAT4F 

(EK) 

1 

| Processes 

i 

ADJUSTABLE DIMENSIONS attribute. 


J CDAT58 

(EK) 

1 

( Processes 

ENTRY attribute. 


| CDAT59 

(EK) 

1 

| Processes 

i 

GENERIC attribute. 


| CDAT5A 

(EK) 

1 

| Processes 
• 

BUILT-IN attribute. 


| CDAT60 

(EK) 

1 

J Processes 

EXTERNAL attribute. 


| CDAT61 

(EK) 

( 

( Processes 

INTERNAL attribute. 


| CDAT62 

(EK) 

1 

(Processes 

1 

AUTOMATIC attribute. 


|CDAT63 

(EK) 

1 

(Processes 

i 

STATIC attribute. 


| CDAT64 

(EK) 

1 

| Processes 

i 

CONTROLLED attribute. 


|CDAT69 

(EK) 

i 

(Processes 

i 

INITIAL attribute. 


| CD AT 6 A 

L 

(EK) 

1 

| Processes 

-L _ . 

LIKE attribute. 

j 


| Routine/Subroutine | Function | 
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Table ELI. Phase EL Routine/Subroutine Directory (cont'd) 

| Routine/Subroutine J Function ] 


| CD AT 6 B 

(EK) 

| Processes DEFINED ATTRIBUTE. 

I 


| CDAT6C 

(EK) 

1 

| Processes ALIGNED attributes. 

1 


| CDAT6D 

(EK) 

1 

| Processes UNALIGNED attribute. 


| CDAT7 0 

(EK) 

1 

| Processes AREA attribute. 


|CDAT88 

(EK) 

1 

| Processes POS attribute. 

i 


| CDCLSC 


1 

| Scans each item of DECLARE statement. 

| 


| CDFATT 

(EM) 

1 

| Applies factored attributes. 

1 


1 CDFLT 

(EM) 

1 

(Applies default attributes. 

1 


| CDICEN 

(EM) 

I 

(Constructs dictionary entry. 

i 


| CGENSC 

(EM) 

1 

(Performs phase initialization and scans chain of DECLARE 

statements. j 

| CHASH 

(EM) 

1 

| Hashes BCD of identifier. 

1 


| DCIDl 


l 

|Main scan routine. 


| DCIDPR 


1 

(Processes factor brackets and level numbers. 


| ECHSKP 

(EK) 

1 

(Initializes and passes control to Module EM. 


| INPATT 

(EM) 

1 

(Applies implicit attributes. 


(INTLZE 


(Performs initialization for each identifier declared. 

i 


j POSTPR 


1 

( Post-processor. 

i 


| SCAN4 

(EM) 

1 

(Scans chain of DECLARE statements. 

1 


| SELMSK 


1 

(Selects correct test mask to be initialized. 


| STRPR 


(Processes inheriting of dimensions in structures. 


| TEMSCN 

L 


1 

(Scans ahead for next level number. 
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Table EP. Phase EP Dictionary Entry III and Call 


I 

| Statement or Operation Type 
(Scans for PROCEDURE entries type 1 


j Follows chain of ENTRY statement 
(entry type 1 entries from a 
(PROCEDURE entry type 1 

j. 

(Examines all labels belonging to an 
j entry type 1, constructing an entry 
jtype 2 or 3, if necessary 

I Follows CALL chain in text making 
(dictionary entries for entry points 

I- 


Main Processing 
Routine 


ENTRY 3 

| None 

EPL40 

+ 

| None 

1 

LBPROC 

| 

(None 

1 


1 

EPL290 

| None 


Subroutines Used 


■H 

-H 

-H 

-H 

-H 


+ 


(Examines the first character of an 
(identifier and sets a flag 
(indicating the range in which it 
I lies 

j Applies default rules 

(Given an identifier calculates its 
j offset in the hash table 

Y 


CDIMAT 


None 




CDFLT 

CHASH 




+ 

None 

f 

None 


1 

I 

I 

1 


(Constructs a dictionary entry 

ISets address slot to zero or the 

( CDICEN 

| None 

j 

j FNDEND 

| None 

lend of the dictionary ( 

(Constructs list of numbers of known |BLDST2 

| 

j None 

| blocks 

j. 

| Built in function name 

j 

j 

j SCANBF 

| None 


™» 


^ 


X L 


•H 

I 
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Table EP1. Phase EP Routine/Subroutine Directory 


r — 


| Routine/Subroutine | 


Function 


h 




BLDST2 

CDICEN 

CDIMAT 

CDFLT 

CHASH 

ENTRY 3 

EPL20 

EPL40 

EPL75 

EPL100 

EPL290 

EPL340 

EPL360 

EPL600 

FNDEND 

LBPROC 

PH SI NT 

PHSMRK 

SCANBF 


Constructs list of numbers of known blocks. 

Constructs dictionary entry. 

Sets flag for default routine. 

Applies default rules. 

Calculates offset in hash table for given BCD. 

Scans ENTRY chain for PROCEDURE statements. 

First entry in entry type 1 chain. 

Scans ENTRY chain for ENTRY statements type 1. 

Return point from LBPROC routine. 

Processes new entry label. 

Scans CALL chain. 

Searches built-in function table for BCD of identifier. 
Blanks out BCD in text. 

Scans the CALL chain. 

Sets address slot for label. 

Processes labels of PROCEDURE or ENTRY statements. 
Initialization of phase. 

Marks later modules as 'wanted* or 'not wanted'. 

Checks for built-in function name. 


._j 
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Table EW. Phase EW Dictionary LIKE 


f T 7 T 1 

| | Main Processing) | 

j Statement or Operation Type j Routine | Subroutines Used j 

i i 1 - -I 

| Scans LIKE chain | EWBEGN |EWCOPY, EWELDM, EWINCH, EWONDM | 

j Updates hash chain for new entry |EWHSCN |None j 

j Calculates start of structure data j EWVART j None | 

| from start of variable information j j | 

j Changes error entry to base element |EWCHEN |None j 

| Copies dimension table entry and | EW2FNT j EWNWBK \ 

| second file statement j j | 


Table EW1. Phase EW Routine/Subroutine Directory 

| Routine/Subroutine J Function | 

ALIGN (EV) * 


BASED (EV) 

CESCN 

EWBEGN 

EWCHEN 

EWCOPY 

EWDCCY (EV) 

EWELDM 

EWELTS 

EWEND 

EWERNC 

EWHSCN 

EWINCH 

EWNOLK 

EWNWBK (EV) 

EWONDM 

EWORDM 

EWSTRT 

EW2FNT (EV) 


Provides correct alignment of base elements in likened structure. 
Inserts or deletes defined slot, where only one structure is based. 
Scans dictionary to find entry corresponding to BCD in text. 

Scans LIKE chain. 

Changes error entry to base element. 

Copies dictionary entry into scratch storage. 

Copies initial dictionary entries and associated second file 
statements, etc. 

Copies entry into scratch storage with dimension data removed. 

Tests whether the likened structure is dimensioned. 

Handles transfer of control to next .phase. 

Processes erroneously "likened" major structure. 

Updates hash chain for new entry. 

Completes entry copy and places it in dictionary. 

Tests whether original structure is dimensioned. 

Obtains new dictionary block and terminates current one in use. 
Copies entry into scratch storage, inserting dimension information. 
Processes dimension information in original structure. 

Tests validity of likened structure. 

Copies second file statement and associated dictionary reference. 
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Table EY. Phase EY Dictionary ALLOCATE 

Main Processing 

Statement or Operation Type 


Routine 


Subroutines Used 


H 


Scans text for explicitly 
pointer-qualified based variables 

Copies dictionary entries for 
explicitly qualified based 
variables 

Second file pointers. Scans 
ALLOCATE statements 
\ ■ 

Completes copied dictionary entry 
for an allocated item 


IEMEX 


EY14 


EY14 


HASH, ATPROC , DICBLD, STRCPY 


-H 




IEMEY 


ATPROC, DICBLD, HASH, STRCPY 




4 

I 

I 

— 4 


Controls ATPROC and ATP ROD routines 
for each member of a structure 


ATPROC With | MOVEST 
second entry 
point ATPROD 


STRCPY 


ATPROC, ATPROD 




Table EY1. Phase EY Routine/Subroutine Directory 
| Routine/Subroutine | 

h + 


Function 


j ATPROC/ATPROD (EZ) 


j DICBLD 

I 

I 

j EY16 

I 

| EY17 

I 

|EY21 

I 

| HASH 

I 

j IEMEX 

I 

j EY14 

I 

| IEMEY 

I 

| MOVEST (EZ) 

I 

| STRCPY 




Complete copied dictionary entry for allocated item by including 
attributes from ALLOCATE and second file statements. 

Collects attribute given for an identifier and copies its dictionary 
entry. 

Processes ALLOCATE statements. 

Processes identifier in ALLOCATE statement. 

Processes major structures. 

Hashes BCD of identifier to obtain its dictionary reference. 

Scans text for explicitly pointer-qualified variables. 

Copies dictionary entries for explicitly qualified based variables. 
Scans second file, reverses pointers. Scans ALLOCATE statements. 
Copies second file statement and associated dictionary entry. 
Controls ATPROC and ATPROD for each member of structure. 


._j 
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Table FA. Phase FA Dictionary 

Context 



j jMain Processing) 

| Statement or Operation Type j Routine | Subroutines Used 

L J. J. 

| Scans text 

(Reorders subscripts; makes 
(dictionary entry for file and 
(variables 

T 

| CE30 

T 

(CENDTS, CETRAN 


| CEID 
event j 

j 

| CESCN 

1 

1 


(Identifies keywords 

j 

( CEKYWD 

1 

jcEKEND, CEKEOB , 
| CEKPRC, CEKSND 

| .... .. 

CEKEOP , CEKON, 

] Scans dictionary 
| 

...- - | 

j CESCN 

1 

| CFPDR2 

1 

4- 

JCESTUC, CEYES, 
(CHASH, CE3XX 

CFPDER , CFPDR2, 

| Makes dictionary entry for 
(variables 

| CDFLT, CDICEN, 

1 

-j- 

CDIMAT, CEONCK 

| „ „ ... 

j Scans dictionary entry for 
(constants and makes new entry, 
j necessary. 

T 

j CECON 

if 1 

1 

| CHASH 

1 

1 

x 


| Scans PICTURE chain entry and 
jnew entry, if necessary. 

makes j CEPICT 
! 

( None 

J 
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Table FA1. Phase FA Routine/Subroutine Directory 


j Routine/Subroutine j 
V 

j CDFLT 

I 

j CDICEN 


Function 


— n 


-H 


I CEBNK 


I 

| CDIMAT 

I 

I I 

I 

|CECON (FB) 

I 

j CEDWAX 

I 

ICEID 

I 

I 

j CEINT 

I 

j CEISUB 

I 

j CEKCEN 

I 

| CEKDCL 

I 

| CEKEND 

1 

j CEKEOB 

I 

| CEKEOP 

I 

|CEKEY 

l 

j CEKIDO 

I 

j CEKON 

I 

| CEKPFR 

I 

j CEKPRC 

I 

| CEKSN 

I 

jCEKSND 

jCEKYWD 


| CENDTS 


I 

jCELP 

I 

I' 

I 

|CEONCK 

I 

j CEPFDR 

I 

jCEPICT (FB) 

I 

|CEBP 

I 

| CESCN 

I 

j CESMCL 

I 

jCESTUC 


Determines default attributes for identifier. 

Constructs default dictionary entry for identifier. 

Determines default scale for identifier. 

Transfer point for zero or blank. 

Scans dictionary entry for constants. 

Subscript prime text marker. 

Reorders subscripts and makes dictionary entries for files and event 
variables. 

Transfer point for constant routine. 

Transfer point for iSDB. 

Transfer point for CALL to get over chain. 

Removes SN from DECLARE statements. 

Processes END keyword. 

Processes end-of-block marker. 

Handles end- of -prog ram marker, or start of second file. 

Transfer point for keyword. 

Transfer point for iterative DO. 

Processes ON keyword. 

Transfer point for picture format item. 

Processes PROCEDURE keyword. 

Moves SN, etc., to output stream. 

Processes start of second file statement. 

Identifies keywords. 

Transfer point for left parenthesis. 

End of text block in output file routine. 

Makes entry for programmer-named ON condition. 

Makes dictionary entry for variables. 

Scans picture chain entry. 

Transfer point for right parenthesis. 

Scans dictionary. 

Handles semicolon. 

Points at next entry in structure chain. 


__j 
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Table FA1. Phase FA Routine/Subroutine Directory (cont'd) 


j Routine/Subroutine j 


Function 


fcETRAN } 

I I 

jCEYES | 

I I 

I CE2L | 

I I 

|CE30 | 

I 1 

|CE31 j 

I I 

| CE32 | 

I I 

I CE300 | 

I 1 

j CE3XX | 

I I 

| CFPDER (FB) | 

I 1 

j CFPDR2 CFB) j 

I I 

| CRASH | 

i I 

| CHASHC j 

I I 

IEMFA 


Translates keyword into transfer instruction. 

Compares structure levels. 

Transfer point for second level marker. 

Controlling Scan of text. 

Tests for end of block. 

Moves one byte to output stream. 

Switches to appropriate routine. 

Compares identifier in text with entry in dictionary. 
Makes dictionary entry for ordinary identifier. 

Makes dictionary for formal parameter. 

Hashes identifier. 

Hashes constant. 

Initializes phase. 


Table FE. Phase FE Dictionary BCD to Dictionary Reference 


| |Main Processing! 

j Statement or Operation Type j Routine j 

| Scans text |CE30 |< 


Subroutines Used 


jCENDTS, CETRAN 


j Scans dictionary jcESCN jCESTUC, CEYES, CFPDER, CFPDR2 , j 
j | j CRASH, CE3XX | 

jehecks for array, function, or jCELP J CEFNCT | 
j pseudo-variable if left parenthesis) j j 
jis found j j | 

I- + + *1 

j Tests for end of text block jCENDTS j CEKEND, CEKIDO, CEKPRC | 
[identifies keywords jcEKYWD ~[cEKEOB, CEKEOP j 
| Makes dictionary entry JNone |CDFLT, CDICEN, CDIMAT | 
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Table FE1 • Phase FE Routine/Subroutine Directory 
| Routine/Subroutine | Function 


| CDFLT 

| Applies default rules. 

I 

-H 

| CDICEN 

1 

| Constructs dictionary entry. 

1 


| CDIMAT 

1 

|Sets flag for default routine. 

t 


| CEFNCT 

1 

| Tests validity of function reference in text. 

i 


| CEKEND 

1 

| Processes END keyword. 


| CEKEOB 

j Processes end-of-block marker. 

i 


| CEKEOP 

1 

(Processes end-of-program marker, or start of second file. 


| CEKIDO 

1 

(Processes iterative DO keyword. 

I 


| CEKPRC 

1 

(Processes PROCEDURE keyword. 

1 


| CEKYWD 

1 

(Identifies keyword, 
j 


| CELP 

j Checks for array, function, or pseudo-variable if left parenthesis 

jis found. 

■ 


|CENDTS 

1 

(Tests for end of text block in output file. 

i 


| CESCN 

1 

| Scans dictionary, 
j 


| CESTUC 

j Points at next entry in structure chain. 

1 


! CETRAN 

1 

(Translates keyword into transfer instruction 

i 


| CEYES 

1 

(Compares structure levels. 

i 


|CE30 

1 

(Controlling scan of text. 

I 


| CE3XX 

l 

(Compares identifier in text with dictionary entry. 

i 


| CFDICN (FF) 

1 

| Makes dictionary entry. 


) CFPDER 

1 

(Makes dictionary entry for statement with ordinary identifiers. 

I 


JCFPDR2 

1 

| Makes dictionary entry for formal parameters. 


| CRASH 

(Calculates offset in hash table for given BCD. 

j 


Table FI. Phase FI Dictionary Checking 


Subroutines Used 


, 


j | Main Processing! 

j Statement or Operation Type j Routine J 

[scans text | CESTRT | CEKEYW | 

[identifies keywords | CEKEYW J CEKEOB, CEKEOP, CEKIDO, CEKSN | 

! + + H 

| Checks GOTO statement references |CEGOTO JNone | 

| Converts GOTO to GOOB, if necessary (CEGOB (None j 

| Checks file references JCF.FILE (None j 

j Checks data list items for validity JCEDTCK jNone | 
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Table FI1. Phase FI Routine/Subroutine Directory 


j Routine/Subroutine j 
^CECMBK 
CEDDOL 
CEDOND 
CEDREF 
CEDTCK 
CEFILE 
CEFNMK 
CEGOB 
CEGOTO 
CEISUB 
CEJUMP 
CEKEND 
CEKEOB 
CEKEOP 
CEKEYW 
CEKIDO 
CEKON 
CEKSN 

CELRCT/CERPCT 
CEOOPS 
CEPRBG 
CERFMT 
CESMCL 
CESTRT 


Function 




Tests value of previous second level marker. 

Processes function names used as control variables for DO groups. 
Processes end of iterative DO groups . 

Tests whether dictionary reference needs to be checked. 

Checks data list items for validity. 

Checks file references. 

Processes function markers. 

Converts GOTO to GOOB, if necessary. 

Checks GOTO statement references. 

Processes iSUBs. 

Bumps scan pointer over dictionary reference. 

Processes END statements. 

Processes end-of-block marker. 

Processes end- of- prog ram marker. 

Identifies keywords. 

Processes iterative DO keyword. 

Processes ON statements. 

Processes statement number. 

Process left and right parentheses. 

Checks validity of keywords in the text. 

Processes PROCEDURE and BEGIN statements. 

Processes remote format references. 

Processes semicolons. 


| Controlling scan of text. 


— j 


Chapter 3: Flowcharts, Tables, and Routine Directories 151 


Table FK. Phase FK Dictionary Attribute 


I 


Statement or Operation Type 


(Main Processing! 
Routine 


Subroutines Used 


— i 


^ 


j Scans attributes area for SETS 
j lists 

h 


j F01A 


None 


1 


j Scans SETS list 

Y 

(Processes constants 
(Processes identifiers 


j F02 

-+ 

j CONPRO 

-+ 

j CESCN 
-X 


None 


-H 

I 

— I 


None 


(CESTUC, CE3XX, CHASH 
.X 


Table FK1. Phase FK Routine/Subroutine Directory 

( Routine/Subroutine | Function 1 


1 CEIDLP 

| Scans qualified name. 

| 

— 1 

1 

| CENQUL 

1 

(Processes unqualified name. 

I 


( CESCN 

1 

(Processes identifier. 

1 


| CESTUC 

1 

(Finds address of next structure in chain. 


| CE3XX 

1 

(Compares current BCD with BCD in hash chain. 

1 


| CHASH 

1 

(Calculates offset in hash table for given BCD. 


(CMPERR 

1 

(Provides termination error action. 


| CONPA 

1 

| Inserts constant in ordered stack. 

i 


j CONPRO 

1 

(Processes constants. 


{ ENDFO 

(Releases control. 


| FOERR2 

(Diagnoses constant greater than 255. 

i 


| FOIA 

1 

| Scans attribute tidy-up area. 


(F02 

1 

| Scans SETS list. 


| F04 

1 

(Completes SETS dictionary entry. 

1 


| GETSCR 

j Obtains scratch storage. 

i 
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Table FO. Phase FO Dictionary ON 


Statement or Operation Type 




| Scans input text for ON, SIGNAL, 
land REVERT statements 

h 


FKMVIT 




Main Processing! 
Routine 


Subroutines Used 


| BEFTRN, CENDTS, QP 


| Moves second file from input text 
j block to output text block 

h 


F2 


j CENDTS, BEFTRN 


^FKDCEN 


4 

{ LABCD 


^ 


I Makes dictionary entries for ON- 
| conditions found in ON, SIGNAL, and 
| REVERT statements 

| Examines BCD of file entries 
j referenced in ON, SIGNAL, and 
j REVERT statements; scans previous 
j entries for ON conditions 

V 


MVSIG 


CENDTS 


j Processes CHECK and NOCHECK list. 

h 


— f 


BEFCHL 


j Creates dictionary entries for 
condition prefixes 


NOMOVE 


j CENDTS, LABCD 
IQP 


•H 


■H 


^ 


Table FOl. Phase FO Routine/Subroutine Directory 


| Routine/Subroutine | Function | 

1‘beFCHL | Processes CHECK and NOCHECK list. | 

I I I 

| BEFTRN | Replaces statements containing dummy dictionary references by error | 

j (statements, and generates error message. j 

i I I 

| CENDTS | Requests a new text block for output. | 

i I I 

(FKDCEN | Makes dictionary entries for ON conditions found in ON, SIGNAL, and | 

j (REVERT statements. | 

| FKMVIT (Scans input text for ON, SIGNAL, and REVERT statements. 1 

I i I 

(FKNOCK (Processes CHECK and NOCHECK lists. ( 

|FKPROC | Scans input text for ON, SIGNAL, and REVERT statements. j 

I I I 

j FP010 (FP) | Chains initial label statements and makes second file dictionary | 

j (entries for each label array initialized in this way. j 

I I I 

( F2 (Moves second file from input text block to output text block. | 

(LABCD | Creates a dictionary entry for each label constant and each entry j 

( j label mentioned in a CHECK list. j 

(MVSIG (Examines BCD of file entries referenced in ON, SIGNAL, and REVERT j 

j (statements; scans previous entries for ON conditions. j 

I I I 

| NOMOVE (FP) (Creates dictionary entry for condition prefix. | 

I I I 

|Q3 (Processes condition prefixes changed in current block. | 

(QP (Determines which condition prefixes require dictionary entries. j 

I I I 

| R8 (Moves statement to output buffer. I 
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•Table FQ. Phase FQ Dictionary Picture Processor 


Statement or Operation Type 


Controls scan of PICTURE chain; 
initializes 


Picture character 9 


* 

|l 

Picture characters S, $, ♦ , 
Picture character V 
Picture character E 
Picture character K 
Picture characters CR, DB 
Picture characters 1,2,3 
Picture character P 




Main Processing 
Routine 


CYBR3 


CYNINE 
CYSDPM 
CYV 
CYE 




None 

— j. ^ 

None 

None 

CYC 21 ^ 


CYK 


Subroutines Used 


CYEK, CYFIND, CYTABL 


^ 


-I 


CYC 21 


^ 


■H 


CYCRDB 

CYOTT 




None 

None 


+ 


-1 

_ I 


Picture character Z 


Picture character * 


h 
13 
h 
1 3 

j. 

Picture character Y 
Picture character G 
Picture characters 6, 7, 8, H 
Picture character M 
Picture character F 


CYP 

CYZ 




CYAST 
CYY 
CYG 
CYSSEH 
CYSTM 


1. 


+ + 






CYF 

CYC97 


None 
None 
None 
None 
None 

^ 

None 

-I 

None 

1 

None 

CYCONV ^ 


Converts integer constants to scale 
factor 

^ 

(calculates scale factor JCYFNT | None | 
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[Rout i ne/Subrout ine | 


\ CYAST 

T 

JCYBR2 


| CYBR3 

j 

| CYC03V 

1 

| CYCPBS 


| CYCRDB 


| CYC21 


| CYC97 

1 

| CYE 


| CYEK 


| CYENDD 


| CYF 


| CYFIND 


| CYFNT 


| CYG 


|CYK 


| CYNINE 


1 CYOTT 


| CY? 


j CYSDPM 


] CYSS 


| CYSSEH 


| CY3TM 


| CYTABL 


j CYV 


| CYY 


| CYZ 

X 


I 

H 


Table FQ1. Phase FQ Routine/Subroutine Directory 

Function 

Processes picture character *. 

Identifies picture character. 

Controlling scan of PICTURE chain. 

Converts integer constant to scale factor. 

Processes picture characters slash (/), comma (,), point (.), and B. 
Processes picture characters CR, DB. 

Adjusts data to terninate picture before illegal character. 

Converts integer constant to scale factor. 

Processes picture character E. 

Completes entry for correct picture. 

Releases control at end of picture chain. 

Processes picture character F. 

Obtains code for next character in picture. 

Calculates scale factor. 

Processes picture character G. 

Processes picture character K. 

Processes picture character 9. 

Processes picture characters 1,2,3. 

Processes picture character P. 

Processes picture characters S, $, ♦, -. 

Processes picture characters 6,7. 

Processes picture characters 8,H. 

Processes picture character M. 

Code table for picture characters. 

Processes picture character V. 

Processes picture character Y. 

Processes picture character Z. 


Chapter 3: Flowcharts, Tables, and Routine Directories 155 




Table FT. Phase FT Dictionary Scan 


Statement or Operation Type 


h 
\i 
h 
M 
I'- 
ll 
h 

n 

i'- 
ll 
h 
M 
h 
I* 
h 
I* 
h 
I* 
h 

ENTRY type 1 entries 
ENTRY type 2 entries 

h 


Main Processing 
Routine 


Subroutines Used 


Scans second file 


AC1 


None 


Scans dictionary 


Bl 


None 


Data variables 


DATVAR 


None 


Event or label variables 


EVLABV 


None 


-H 

I 

■H 

I 

■H 

I 

■H I 


Dimension attributes 


Scans AUTOMATIC chain 


— + 


FO 

G2 


None 


None 


Scans STATIC chain 


G3 


None 


Scans CONTROLLED chain 


GE1 
+ 


None 


Sets dope vector required bit 


P1A 


None 


] 

-I 


QA4 

QA3 


None 

— |— 

PROPIC 


H 

I 

—I 


ENTRY type 3 entries 


QA2 


None 


ENTRY type 4 entries 


QX 


None 


ENTRY type 5 and 6 entries 


QA1 


^PROPIC 


Constants 


CONST 
+ 


None 


I 


Structures 


STRUCT 


AJDMRT, MKDMTB, MVTXT 
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Table FT1. Phase FT Routine/Subroutine Directory 

| Routine/Subroutine | Function ] 

| 1 -J 

| AC1 | Scans second file. J 

I I I 

|AC2. j Detects second file statement marker. j 

I I I 

|AF3 | Points relevant dictionary entry at statement. | 

I I I 

| A JDMRT | Modifies second file statements to initialize dope vectors for base | 

j j elements, rather than for the containinc. structures. | 

It I 

| Bl j Scans dictionary. j 

I I I 

{ BIA | Initializes dictionary scan. | 

I I I 

| CONST | Processes constants. J 

j DATVAR j Processes data variables. j 

I I I 

| EVLABV | Processes event or label variables. | 

I I I 

| FO | Processes dimension attributes. | 

I I I 

| FULIN | Moves initial label statement to the second file, collecting | 

| | together all statements for the same array. j 

I I I 

|GE1 | Scans CONTROLLED chain. | 

|G2 | Scans AUTOMATIC chain. | 

I I I 

JG3 | Scans STATIC chain. | 

I I I 

JMKDMT3 | Creates dimension tables. | 

J MVTXT | Moves text blocks. | 

I I I 

J PROPIC | Extracts precision data from picture tables. j 

II" I 

JP1A | Sets 'dope vector required' bit. | 

|QA1 j Processes ENTRY type 5 and 6 entries. j 

j QA2 j Processes ENTRY type 3 entries. | 

JQA3 j Processes ENTRY type 2 entries. j 

I I I 

|QA4 | Processes ENTRY type 1 entries. | 

j QX j Processes ENTRY type 4 entries. j 

I I I 

| STRUCT | Processes structures. | 

II I 

| TRVECT | Transfer vector for appropriate chaining routine. | 
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Table FV. Phase FV Dictionary Second File Merge 

r T T 

Main Processing 

Statement or Operation Type 


Routine 


Subroutines Used 


Reverses second file pointers; 
scans text for block heading 
statements; allocates statements 
and references to dynamically 
defined data 


IEMFV 


DATCPY, DEFMOV, DEFTST, F2M0VE , 
MOVE 


Examines ADF references in second 
file; completes defined item 
dictionary entry 


DEFCOM 


None 


Detects dictionary references which 
refer to dynamically defined data 


DEFTST 


None 


Examines dictionary references and 1DATCPY 
moves any associated second file 
statements to tne output string 

k + 


F2M0VE, MOVE 


Inserts dictionary reference of 
pointer in associated based 
variable entry 


FVPTR 


None 


Processes adjustable extents on 
cased arrays 


FVADV 


+ 

None 


+ 

None 


-H 


■H 


Processes adjustable lengths on 
based strings 


FVSDV 


j 
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Table FV1. Phase FV Routine/Subroutine Directory 

|Routine/3ubroutine j Function | 

[datcpY | Moves second file statements associated with dictionary reference to| 

j j output string. | 

I I I 

| DEFCON (FW) (Examines ADF references in second file; completes defined item | 

j (dictionary entry. ( 

I I I 

| DEFMOV (Modifies text references to dynamically defined data. | 

! I I 

| DEFTST | Detects dictionary references which refer to dynamically defined | 

j j data . | 

I I I 

| FVO | Scans second file reversing pointers. | 

I I I 

|FV9 (Initializes text scan. | 

I I I 

| FV10 | Scans text . | 

I I I 

|FV16 (Releases control. | 

I I I 

| FV18 (Processes ALLOCATE statements. | 

1 I I 

(FV19 (Processes PROCEDURE statements. ( 

I I I 

| FV20 | Processes BEGIN statements. | 

I i I 

JFV34 (Scans AUTOMATIC chain. I 

I I I 

( FVPTR (Inserts D.R. of pointer in associated based variable entry. ( 

(FVADV (Processes adjustable extents on based array. | 

i I I 

JFVSDV (Processes adjustable lengths on based strings. ( 

J F 2 MOVE (Moves second file statement to output string. j 

(IEMEV (Controlling scan of second file; invokes processing routines. | 

(MOVE (Moves text from input string to output string. j 

L -L J 
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Table FX. Phase FX Dictionary Attributes and Cross Reference 


Statement or Operation Type 


I 
I 

j Scans STATIC chain for all items 

j Scans PR0CEDURE-3EGIN chain 

j Scans CONTROLLED chain for 
j non-parameter DECLARED, CONTROLLED 
| dictionary entries 


Main Processing 
Routine 


FX0000 


FX0100 


Subroutines Used 


FX0010 


H 


FX0010, FX0101, FX0105, FX0120 


FX0170 


None 


k- 


— f 


j Scans parameter list from PROCEDURE 
jand ENTRY statements 

h 


FX0101 


FX0010 


■H 


| Sorts BCD of variables and creates 
j entries in scratch text storage 

H 


FX0010 


None 


— I 


| Scans circular chain of ENTRY 
j statement dictionary entries 
j associated with a particular 
j PROCEDURE statement 

j Scans AUTOMATIC chain associated 
j with particular PROCEDURE or BEGIN 
j block 

| Prints heading line for tables 
| according to options specified 

j Scans sorted chain of identifiers 

j Determines attributes of a given 
| identifier if the ATR option is 
| specified 

h 


FX0105 


FX0101 


FX0120 + 


FX0010 \ 


FXHD 


ATTMOV 


FXPRNT 

FX0299 


FX0299 


-+ 


ATTMOV, FXBCD , FXDCLN, FXEND, 
REFMOV 


+ 

FXDCLN 


-H 


| Scans the chain of references for a 
| given identifier (if XREF is 
| specified) and prints them in 
(external decimal form 

h 


REFMOV 


j Converts EBCDIC of particular 
(attribute to required external form 
land moves it to print area 

j. 

j Prints BCD of identifier having 
j converted it from internal form to 
j external form 

j Converts an internal binary number 
j to external decimal form and moves 
jit to print buffer 

(Frees all scratch text storage and 
(releases control to next phase 



ATTMOV 


None 


^ FXBCD 


None 


■H 


FXDCLN 


None 


FXEND 


+ 

None 


4 


—j 


IbO 




| Routine/ Subroutine j 


Table FX1. Phase FX Routine/Subroutine Directory 

Function 

Converts EBCDIC data to required form, moves data to print area. 

Moves identifier BCD to print area, determines options to be 
printed. 

Converts binary number to external BCD, moves it to print area. 
Frees scratch storage, releases modules, releases control. 

Prints heading line for table according to options specified. 

Scans sorted chain of identifiers. 

Scans STATIC chain. 

Sorts BCD of variables and creates entry in text for each item. 
Tests for end of STATIC chain. 

Scans PROCEDURE- BEGIN chain. 

Scans parameter list from PROCEDURE and ENTRY statements. 

Scans circular chain of ENTRY statement dictionary entries 
associated with a particular PROCEDURE statement. 

Scans AUTOMATIC chain associated with particular PROCEDURE or BEGIN 
block. 

Scans CONTROLLED chain for nonparameter DECLARED CONTROLLED 
dictionary entries. 

Scans text, making chain of references to each dictioary entry. 

Determines attributes of a given identifier if the ATR option is 
specified. 

Moves the references to an identifier to the print buffer and 
prints . 


| ATTMOV (FY) 

| 

| FXBCD (FY) 


| FXDCLN (FY) 


| FXEND (FY) 


| FXHD (FY) 


| FXPRNT (FY) 


| FXOOOO 


| FX0010 


| FX0030 


| FX0100 


| FX0101 


| FX0105 


| FX0120 


J FX0170 


| FX0250 


j FX0299 


| REFMOV (FY) 



._j 


•Table FI. Module FI Compiler Control 


| | Main Processing! 

I Function j Routine | Routines Used 

| Checks whether syntax check should jlEMFl j ZABORT, ZUPL, RLSCTL 

| terminate compilation j j 

I Entry to the operating system : | j 

j None j j 
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Chart 04. Pretranslator Logical Phase Flowchart 


61 ♦ . 

.* * . 

.♦ FILE ♦. YES 

CR OPEN .* 

*. CONSTANT . * 

* . .* 

♦ . . * 

♦ NC 


•♦***B2*** ******* 
•DCES GA* 

*- »- ♦- *- *- *- *- ♦-* 
->♦ CREATE * 

* DCES AND OCES * 


Cl *. 

. * I/O *. 
.♦STMNTS AND *. YES 

*. 2ND LEVEL . ♦ 

*. MARKERS .* 

*. . * 

*. .* 

♦ KC 


*****C2*** ******* 

*1/0 MOD GB* 

*-*-♦-*-*-*-*-*-* 
->* MODIFY * 
* 1/0 PARAMETERS * 


.♦ ANY *. 

.* FUNCTION *. YES 

*. REFERENCES .♦ 

*.CR OFT=l .♦ 

* . .* 

*. . * 

* NO 


* ****D2*** ******* 

♦KATCH1 GK* 

*-*-*~ *- *- *- *- *- * 
->* CHECK ♦ 

* PARAMETER * 

* MATCHING • 


.* ANY *. 

NO . * FUNCTION *. 

* . REFERENCES . * 

*. .* 

*. .* 

* . .* 

* YES 


*****F2********** 

♦ GO* 
*- *_♦_♦_*_*_*_*_ * 

♦ FRE- PROCESSOR *- 

* FOR GP ♦ 

* * 
***************** 


.♦ ANY *. YES 

CHECK . * 

*. LISTS .* 

♦ . . * 

* . .* 

* NO 


*****G2********** 
•CHECK LIST GU* 
*-*-*-*-*-♦-*-*-* 
->* PROCEED CHECK * 

* CONDITION ♦ 

♦ STMNTS * 
***************** 


.* . 

HI ♦ . 

.* *. 

. • STRUCT *. YES 

. ASSIGNMENTS .* 

•OR EXPRESS-* 
♦.IONS .* 

*. . * 

* NO 


•••••H2********** 
♦STROCTS HP* 

«- *- *- *- *- ♦- *- *-* 
->♦ PROCESS * 

* STRUCTURE * 

* ASSIGNMENTS * 


.* ARRAY *. YES 

*. ASSIGNMENTS .* 

•OR EXPRESS-* 
•.IONS .* 

*. .♦ 

* NO 


*****j2********** 
•ARRAYS HK* 

♦-*-*-*-*-*-*-*-* 
->* PROCESS * 

* ARRAY • 

* ASSIGNMENTS • 


.* ANY •. YBS 

• . ISUB DEFINED .* 

*. ITEMS -* 

*. .♦ 

*. . * 

* NO 
I ***• 

*05 * 

U>* A1 * 


•****K2* *♦*••**** 
•ISUBS BP* 

*-*-♦-*-*-*- *- *- * 
->* PROCESS ITEMS * 

* DEFINBD * 

• USING ISUBS • 


• •*• 
*05 • 
->« A1 * 


♦♦♦♦*F3********** 
•MATCH2 GP* 




— >♦ SECOND CBBCK * 


• ON PARAMETERS * 


* * 
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Chart GA. Phase GA Overall Logic Diagram 



• GET NEXT 

♦ ENTRY IN 

* STATIC CHAIN 


FILE 

CONSTANT 
. ( 08 ) 


* CHECK ATTRIBS * 

* AND MAKE OPEN * 

* CONTROL BLOCK ♦ 


«****G1 ********** 

* MAKE DICT ♦ 

i • ENTRY AND * 

t ♦ CHAIN PROM * 

* STATIC ENTRY ♦ 

* * 
**•**•*♦***••**•* 


* FILENAME TO ♦ 
♦SKELETON DCLCB * 
♦CHANGE SYSPRINT* 

• TO IHESPRT ♦ 


♦ CHECK ATTRIBS ♦ 

♦ AND MAKE OPEN ♦ 

♦ CONTROL BLOCK ♦ 


****• 03 * ********* 

♦ MOVE OCB INTO ♦ 

♦ APPROPRIATE * 

♦ PART OF DCLCB ♦ 

♦ SKELETON ♦ 


GET ENVMNT * 
STRING *- 

(MAY BE NULL) ♦ 

* 

**************** 


IHEENV, 


♦CHECK AND PLACE 

♦ IN SKELETON 

♦ DCLCB 


COBOL IN 
ENVMNT 
. STRING 


♦SET COBOL FLAG 
>♦ ON IN ATTRIB 
♦ ENTRY 
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Chart GB. 


Phase GB Overall Logic Diagram 


♦♦♦•♦Al ♦♦♦••♦♦♦♦• 
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* INITIALIZE ♦ 

* TEXT POINTERS ♦ 
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* * 
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***************** 
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<- 

" 


*. 


• * . 
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.* 


. * 


C4 


C5 
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NO 


NO 
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Chart GK 


Phase GK Overall Logic Diagram 
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Chart GP. Phase GP Overall Logic Diagram 
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Chart GU 


Phase GU Overall Logic Diagram 
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Chart HF. 


Phase HF Overall Logic Diagram 
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Chart HK. Phase HK Overall Logic Diagram 
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Chart HP. Phase HP Overall Logic Diagram 
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Table GA. Phase GA DCLCB Generation 


I 


T T 

| Main Processing! 
j Routine | 

+ 

| IL0100 | IL0110, IL0120 


Subroutines Used 


Statement or Operation Type 
(Scans STATIC chain 

(Generates DECLARE control block |IL0110 ~[cHKATT, IHEENV 

| entry | j 

(Generates OPEN control block entry (IL0120 jcHKATT 


^ 


4 


L J 


Table GA1. Phase GA Routine/Subroutine Directory 

[Routine/Subroutine | Function ] 




j CHKATT 

j Checks attributes and creates control words. 



( IHEENV 

1 

| Checks environment options, and inserts them 
j blocks . 

t 

into DECLARE control 


| IL0000 

j Entry point from compiler control. 

i 



(IL0100 

1 

| Scans STATIC chain. 



| IL0110 

1 

(Generates DECLARE control block entry. 



| IL0114 

1 

JTest point for environment entry. 



| IL0115 

1 

| Return point from environment processina. 

i 



| IL0117 

1 

(Processes file attributes entry. 

1 



J IL0118 

1 

( Branch point of SYSPRINT file found. 

1 



| IL0120 

1 

(Generates OPEN control block entry. 



| IL0200 

1 

(Releases control. 


j 
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Table GB. Phase GB Pretranslator I/O Modification 


1 ' 

| Statement or Operation Type 
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j Routine j 

.1 X 
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r ■ JL ” “ 
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j 
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1 
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1- "* — ~ 
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j relevant list in data lists, adds 
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1 

| SCAN2 

1 

1 

j. 

T 
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1 

1 

j 


r t 

| Expands iteration factors in format | FORLST 
j lists j 

L i 

j None 

1 


r 

| Checks for use of COBOL files in 
|READ, WRITE, and LOCATE Statements 

l 

l > 

1 •*=■ 

1 

i 

1 

1 

1 

1 

i 

| LOCATE 
j COPY, 

J. 
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H 

H 

H 

■H 

H 
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Table GB1. Phase GA Routine/Subroutine Directory 

r 7 7 — 1 

(Routine/Subroutme| Function | 

h + -1 

(AFORMT | Processes FORMAT statements. | 

I I I 

| A4 (Checks for use of COBOL files in READ, WRITE, and LOCATE statements.! 

I I I 

| A 6 | Scans source text for GET and PUT statements. | 

i i i 

|A 8 | re-orders options to put EDIT, DATA, or LIST last. | 

I t I 

|A21 | Scans GET or PUT statement for data specification. | 

j COPY (GC) j Copies a structure and places the copy on the COBOL chain. Sets up | 

I | text skeletons. j 

I I I 

| DELETE (GC) (Removes an offending I/O statement and inserts an error statement in| 

j (the output text. j 

(FORLST (Expands iteration factors in format lists. | 

JF2 (Creates and buys integer temporary. j 

(F5 (Scans and outputs format item. j 

| F5A j Sells temporary. | 

I ! I 

| F 6 | Tests for end of format list. | 

I I I 

(F 6 A (Tests for end of format specification. ( 

j F 6 B (Outputs end of format specification. | 

I I I 

|F7 | Scans format list. ( 

| LAB 17B (Processes format list in GET or PUT statement. j 

I I I 

(LLDOIT (Moves DO specifications to precede relevant list in data lists, adds| 

j (END statements. j 

| LOCATE (GC) j Checks for the use of a COBOL file, and puts out a warning | 

j (diagnostic. | 

I I I 

(MAP (GC) (Compares the PL/I and COBOL and PACKED (NONSTRING) mappings of a | 

j (structure. j 

j MKROOM j Provides space in a statement in new source file. j 

I I I 

| MR (Initializes text blocks and pointers, and obtains scratch storage. | 

I I I 

(READ (GC) (If a READ IGNORE is encountered, no action is taken. If a READ SET | 

j j is encountered, a warning diagnostic is given. If a READ INTO for aj 

j (structure is encountered, PL/I and COBOL mappings are compared. j 

j SCAN2 j Scans option list for end of option or statement, expands DO 1 

j (specifications, and changes certain function markers into j 

j (pseudo-variable markers. | 

I I I 

| SCNS (Scans option list for end of option or statement. | 

ISTSCAN (GC) j Stores the dictionary reference of the file and the INTO/FROM ( 

j j variable, and sets flags. | 

I 1 I 

I WRITE (GC) j For structures, the PL/I and COBOL mappings are compared. j 
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Table GK. Phase GK Pretranslator Parameter Matching 1 


1 


Statement or Operation Type 


(Main Processing! 
Routine I 


Subroutines Used 


— i 


k 

| Scans source text for function 
j markers 

L - 



| BASCAN 

1 

jcPSTMT, 

1 

CRSTMT 


« 

(Processes function, puts out 
| reference and initial code bytes 

L , 

j BAFM 

1 

I . 

j SCANRP 

1 

A 



1 

| Processes arguments 

j BALOOP 

-j- 

1 

| ADDTGT, 

SCNCRP 


r ■ ■ 1 ■“ 

(Checks numbers of arguments 

j ARGNOQ 

| None 




H 


Table GK1. Phase GK Routine/Subroutine Directory 

r t 

| Routine/Subroutine | Function 

^ + 


( ADDTGT 

(Adds data to output text. 

■ 


(ARGNOQ 

1 

(Checks number of statements. 


(BABT3 

1 

(Tests for STOP marker. 


| BACALQ 

1 

| Outputs function and first bytes of argument list. 

i 


( BADELM 

1 

| Tests for end of argument list. 

1 


(BAFM 

(Processes function, puts out reference and initial code bytes. 


| BAFST 

1 

| Locates SETS list and parameter list for function. 

i 


( BALOOP 

1 

(Processes arguments. 

i 


( BALPQ 

1 

| Tests whether argument list is present. 

i 


| BAMORE 

(Accesses next argument in list. 

i 


| BA NORM 

1 

|Sets STOP marker to scan argument. 

1 


| BAPVM 

1 

| Examines pseudo- variable • 

i 


| BARECQ 

1 

| Tests for nested function reference. 

| 


| BARGFN 

j Outputs warning message. 

1 


( BASCAN 

1 

(Scans source text for function markers. 

1 


| BASTOP 

j Outputs argument. 

■ 


| CPSTMT 

1 

|Adds closing bytes of a statement to output text. 


1 CRSTMT 

1 

(Adds first bytes of a statement to output text. 

1 


| SCANRP 

(Scans argument list. 

i 


( SCNCRP 

i 

| Scans argument. 

• . . 

J 
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Table GO. Phase GO Preprocessor Parameter Matching 2 


j | Main Processing) 

I Statement or Operation Type j Routine j 

I- + + 

(Initialization and scratch core jPMATCH j POLYMV 

(utilization for Parameter Matching j j 

1 2 | | 

L J. A 


Subroutines Used 


Table GOl. Phase GO Routine/Subroutine Directory 


r t 

( Routine/Subroutine | 

^ + 

| PMATCH | General initialization and scratch core utilization for Parameter 

j (Matching 2. 

I I 

(Moves the routines POLY1, POLY2, POLY3, P0LY4 and POLYS into scratch 
j storage (see Table GP) . 


Function 


( POLYMV 

[ 
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Table GP. Phase GP Pretranslator Parameter Matching 2 

r — t - - r - - 

Main Processing! 

Statement or Operation Type 


h 


Routine 


Subroutines Used 


■H 


H 


h 


Scans text for procedure and 
function calls 


BS1 


ADDTT, STKINF, UNSTCK 


Examines argument lists for 
expressions 

i + + 


Creates temporaries for scalar 
expressions and constants 


BS4 

Ml 6 


EXSCAN, Ml, M4, Ml 6, SCANFR 


ADDTT, COPYTP, MKDCEN, SETBUY ' 


^ ADDTT, CHCKB1, COPYTP, MKDCEN, ^ 

SETBUY 


h 


Creates temporaries for array 
expressions 


Creates temporaries for partially 
subscripted array expressions 


E2 




E3 


ADDTT, CHCKB 4, COPYTP, MKDCEN, 
SETBUY 


■H 


H 


Creates special temporaries for 
partially subscripted arrays 


EX16 


Checks single arguments (except 
structures) with parameter 
descriptions 


M4 


ADDTT, BS2, CHCKB 4, CHECKT , C0PYT1, 
MKDCEN, STKINF, UNSTCK, Zll, 

SETBUY, SETMT 

CHECKT, Ml 6 


^CHECKS, CSTTMP 


Checks single structure arguments 


Creates temporaries for structure 
expressions 


M5 

M21 


CSTMP2, MKDCEN, CHCKB4 , SETMT, 
ADDTT 


4 


Creates temporaries for partially 
subscripted structure 

Compare the two arguments of the 
POLY function and create 
temporaries if the arguments are 
not both floating and do not have 
the same scale and precision 




Z22 


POLY1, P0LY2, 
POLY3, POLY4, 
POLY5 


BS2, ADDTT 


BS2 


-H 

I 

I 


Creates special dictionary entries 
for generic entry labels used as 
arguments 


M37 


None 
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Table GP1. Phase GP Routine/Subroutine Directory 

r T 

| Routine/Subroutine | 


| ADDTT (GR) 


| BS1 


| BS2 


| BS4 


| BS10 


| BS33 


| CHCKB1 (GR) 


ICHCKB2 (GR) 


| CHCKB3 (GR) 


1 CHCKB4 (GR) 


| CHCKS1 (GR) 


| CHECKB (GR) 


| CHECKS (GR) 


| CHECKT (GR) 


| COPYTP (GR) 


| C0PYT1 (GR) 


| CSTTMP/CSTMP2 

(GQ) | 

| EXSCAN (GQ) 


| EX16 (GQ) 


| EX36 (GQ) 


|E2 (GQ) 


| E3 (GQ) 


| MKDCEN (GQ) 


| Ml (GQ) 


| M2 (GQ) 


| M4 (GQ) 


|M5 (GQ) 


|M6 (GQ) 


|M10 (GQ) 

— J. 


Function 

Adds text to output block. 

Scans input text. 

Scans input text. 

Examines argument lists for expressions. 

End- of -program routine. 

Tests for constant argument. 

Compares the bounds of argument and parameter arrays, and creates 
new dimension tables for temporary arrays. 

Compares the bounds of argument and parameter arrays where the 
argument is partially subscripted, and creates new dimension tables 
for temporary arrays. 

Creates a new dimension table from a parameter description. 

Creates new dimension tables for partially subscripted array and 
structures. 

Compares the structuring of argument and parameter structures. 

Compares the bounds of argument and parameter arrays. 

Compares structuring and data types of argument and parameter 
structures . 

Compares data types of arguments and parameters. 

Creates a temporary dictionary entry from a parameter description. 

Creates a temporary dictionary entry for a partially subscripted 
array from a parameter description. 

Create temporary structure dictionary entries. 

Scans expressions for arrays and structures. 

Creates temporary arrays for partially subscripted array arguments. 
Creates a chameleon dictionary entry. 

Creates temporaries for array expressions. 

Creates temporaries for partially subscripted array expressions. 
Makes dictionary entries. 

Examines argument expressions. 

Examines single arguments with parameter descriptions. 

Compares single arguments with parameter descriptions. 

Examines structure arguments. 

Tests for structure parameter. 

Processes subscripted variable argument. 
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Table GP1. Phase GP Routine/Subroutine Directory (cont* d) 


I 

H 


| Routine/Subroutine j 


Function 


Y- 


M12 (GQ) 

M13 (GQ) 

M14 (GQ) 

M16 (GQ) 

M21 (GQ) 

M22 (GQ) 

M23 (GQ) 

M24 (GQ) 

M37 (GQ) 

M41 (GQ) 

K44 (GQ) 

POLY1 , P0LY2, 

POLY 3, P0LY4, 

POLY 5 (all in GO) 

SCANFR 

SETBUY (GQ) 

SETMT (GR) 

STKINF 
TESTC 
UNSTCK 
Zll (GR) 

Z22 (GR) 


Creates a warning message. 

Gets BUY text. 

Processes scalar argument. 

Creates temporaries for scalar expressions and constants. 

Creates temporaries for structure expressions. 

Processes data item parameter. 

Processes label parameter. 

Creates a structure temporary. 

Creates dictionary entries for generic entry labels which are 
arguments. 

Error routine. 

Processes dimensioned scalar argument. 

Check the arguments to the POLY function and generate code to buy 
temporaries, if the arguments are not both floating and do not have 
the same scale and precision. 

Scans for matching parentheses. 

Inserts skeletons to buy temporaries in the output text. 

Sets temporary dictionary references in MTF compiler functions for 
array and structure bounds. 

Stacks information on encountering nested functions. 

Tests for constant argument. 

Unstacks information. 

Generates text to set up the dope vectors of partially subscripted 
array temporaries. 

Generates text to assign the structure subscripts of partially 
subscripted structures fcp temporaries, and then to set up the dope 
vector for the partially subscripted structure temporary. 
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Table GU. Phase GU Pretranslator Check List 
f 


T T* 

| Main Processing! 
Routine 


| Statement or Operation Type 


Subroutines Used 


j Scans statement; checks if 
| preceding SIGNAL statement is 
j needed 

| BSCAN 

1 

1 

j _ 

| CALL, LIST, MOVE, SUOPQ 

1 

1 




| Scans statements; checks if 

1 following SIGNAL statement is 
(needed 

L . . 

j A SCAN 

I 

1 

_ i 

j None 

1 

1 

L 


r 

| Provides a SIGNAL CHECK statement 

+ 

j CALL 

i 

T 

| GENTST 


r — ~ — 

| Searches list for checked items 

T 

j SUOPQ 

A 

j . 

(call, LIST 

X_ — 



H 


_j 
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r — 7 t- 

| Routine/Subroutine J 


r — — 
j ABGNDO 


T 

| AFM 



| ASC 



| ASCAN 



| ASCL 



| ASPECL 



| ASTMT 



| ATEST4 



| ATEST5 



| ATST3 



| BENTON 



| BPC 



| BSCAN 



| BSTMT 



| BTEST3 



| BTEST4 



| BVARNO 



I 

j CALL (GV) 


1 

j CALLBA 

(GV) 


1 

j CALLEX 

(GV) 


1 

jCALLIF 

i 

(GV) 


1 

j CALSTM 

(GV) 


1 

jCALSYM 

i 

(GV) 


1 

j GENTST 



1 

j LIST (GV) 

i 


l 

|MOVE 



1 

| SUOPQ 

l 

(GV) 

j 


Table GUI. Phase GU Routine/Subroutine Directory 

Function 

Sets IF-switch for THEN or ELSE clause. 

Signals checked items in argument list. 

Tests statement identifier and takes action if necessary. 

Scans statements; checks if following SIGNAL statement is required. 
Examines statement dictionary entry. 

Examines statement dictionary entry which is not a label. 

Housekeeping for end of statement. 

Tests for argument list. 

Tests for THEN. 

| Tests for end of statement. 

[Test whether argument list contains checked item. 

Processes "possible check" statement. 

Scans statement; checks if preceding SIGNAL statement is required. 
Tests whether SIGNAL statement may be needed after statement output. 
Tests for end of statement. 

Tests for argument list. 

Tests for END statement. 

Outputs SIGNAL statement for checked item. 

| Tests whether SIGNAL precedes or follows statement responsible. 

Exit from subroutine CALL. 

Tests whether DO statement must be output. 

| Re-outputs overwritten statement after DO statement. 

(Outputs SIGNAL statement. 

| Checks space in output text block. 

Updates and searches list of currently checked items. 

Moves text from source to output. 

Searches list for checked items. 

j 
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Table HF. 
r 


Phase HF Pretranslator Structure Assignment 


Main Processing 
Routine 


*- 


Statement or Operation Type 


Subroutines Used 


Scans text for structure assignment 
Statements, regions of nested 
statements, output list 
expressions, and structure 
references in input lists 


MR 


BYNAME, GENTST, LSTSCN, MOVE, 
NSTSCN, STRASS, STREXP, STRURE 


+ 


Expands structure assignments and 
expressions into a set of scalar 
assignments or expressions 
corresponding to the base elements 
of the structure operands. Where 
the base elements are arrays, the 
corresponding component expressions 
or assignments are surrounded by 
appropriately iterating DO groups 


BYNAME, STRASS, 
STREXP, STRURE 


DVCON, GENTST, LSTSCN, MOVE, 
NSTSCN, SBGN 


Scans regions of nested statements 
for structure assignments 


NSTSCN 


MOVE, NSTSCN, STRASS 


■H 


Adds text to the output string 


MOVE 

GENTST 


GENTST 


Determines space availability in an 
output text block 


MOVE 


Scans function argument and 
subscript lists 


LSTSCN 


MOVE, NSTSCN 


-H 


h 


Constructs DO statements and checks 
bound equivalence 


DVCON 


GENTST 


Constructs subscript lists for 
references to dimensioned structure 
base elements 


SBGN 


GENTST 


■H 
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Table HF1. Phase HF Routine/Subroutine Directory 
| Rotitine/Subroutine | 


Function 




+- 


•H 


BYNAME (HG) 
BYNl (HG) 
BYN11 (HG) 
BYNl 3 (HG) 
DVCON (HG) 
GENTST 
LSGET 
LSTSCN 
LS21 
LS23 
MOVE 
MR 

MRBYN 
MRTRT 
NSTSCN 
SADRAB (HG) 
SAEND (HG) 
SAOP (HG) 
SATRT (HG) 
SAX1 (HG) 
SA20 (HG) 
SA32 (HG) 
SA36 (HG) 
SA73 (HG) 
SA79 (HG) 
SBGN 

STRASS (HG) 
STREXP (HG) 
STRURE (HG) 


Expands BYNAME structure assignments. 

Searches for matching BCDs down to base elements. 

Returns to start of current output assignment statement. 

Test for matching BCDs. 

Constructs DO statements, checks bound equivalence. 

Determines space in output text block. 

Tests for GET statement. 

Scans subscript arguments and subscript lists. 

Tests for structure item in data specification. 

Tests for data-directed data specification. 

Adds text to output string. 

Scans text for structure assignment statements, nested statements, 
output list expressions, and structure references in input lists. 

Tests for BY NAME assignment statement. 

Scans source text for structures. 

Scans regions of nested statements for structure assignments. 
Builds up stack to show pattern of structure. 

Tests whether END statements need to be output. 

Examines dictionary reference found. 

Scans structure expression or assignment. 

Tests whether item matches the stack pattern. 

Tests for start of structure expression. 

Outputs base element and replaces it in source text. 

Tests for BY NAME assignment statement. 

Outputs END statements. 

Resets scan pointer to start of expression/assignment. 

Constructs subscript lists for references to dimensioned structure 
base elements. 

Expands structure assignments into DO loops. 

Expands structure expressions. 

Expands structure references. 


j 
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Table HK. Pretranslator Array Assignment 


Statement or Operation Type 


f 


(Main Processing! 

| Routine j 

4 f 


Subroutines Used 


j Scans text for array and scalar 
(assignment statements 

| MR 

1 

j None 

1 

4- - 


| Scans text for nested array and 
| scalar assignment statements 

L 

'(MR 

[ 

— t — 

j NESTAT 

1 

| 


r t 

| Scans text for array expressions in (MR 
| I/O lists in GET and PUT statements! 

( ARRASS, 

1 

_ 

LSTSCN 

(Expands arrays into DO loops and 

| ARRASS 

j FRETMP, 

MDE f OPTST, SLGCH, SUBSKP 


(scalar assignments; checks 
(dimensions and bounds 




Table HK1. Phase HK Routine/Subroutine Directory 


| Routine/Subroutine | 


Function 


(AADOP (HL) 

(Examines leftmost operand. 

— 1 

| AAMULA (HL) 

1 

(Tests for multiple assignment. 

| 


| AA3 (HL) 

(Checks pseudo- variables. 

i 


( AETRT (HL) 

1 

(Scans array expression. 

i 


| ARRASS (HL) 

1 

(Expands arrays into DO loops and scalar assignments; checks 
(dimensions and bounds. 

1 


| ARREXP (HL) 

1 

(Generates DO loops and subscripts for array references. 

i 


| ARRIN (HL) 

1 

(Entry point for array expressions in input lists. 

i 


(ARROUT (HL) 

1 

| Entry point for array expressions in output lists. 


| FRETMP 

i 

(Generates a SELL statement for temporaries bought in the current 

j statement. 

1 


| LSTSCN 

1 

( Scans I/O lists for possible array expressions. 

i 


| MDE 

1 

(Makes a temporary dictionary entry, 
j 


(MR 

j Scans text for array and scalar assignment statements, for nested 
j array and scalar assignment statements, and for array expressions 

(GET and PUT statements. 

1 

in| 

| MREOP 

1 

| Tests for end of text. 


|MRTRT 

1 

(Scans text. 


| NESTAT 

1 

| Scans nested statements. 

i 


| OPTST 

(Tests any given operand. 

1 


| SLGCH 

1 

(Generates and checks subscript lists. 

| 


| SLMCG 

1 

(Inserts subscripts in expanded array position. 


| SUBSKP 

1 

(Skips a subscript or subscript list. 
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Table HP. Phase HP Pretranslator iSub Defining 


Statement or Operation Type f 


H 

| Scans source text, for references | MASCAN 
I defined by iSUB 

I* 

| Processes references defined by 
liSUB 

| Scans subscripts 


| Main Processing! 
Routine f 


Subroutines Used 


+ 

| MOVE 


DEFSUB 


jGENTST, MOVE, SULIST, SUMOVE 

I 

-+ 


H 


I SUMOVE | None 

| Cin SULIST) | 


,_J 


Table HP1 . Phase HP Routine/Subroutine Directory 


-1 

I 

H 


| Routine/Subroutine | 


| DEDONE 


| DEEND 2 


| DEFSUB 


| DEGBDl 


1 DENE XT 


| DENGUB 


j DERCUR 
\ 

j DERETN 


j DETEMQ 


| GENTST 


| INIT 


j MASCAN 


| MOVE 


| SULIST 


| SUMOVE 


| SUSCAN 


J SUSUBS 

J. 


Function 

Resets pointers to scan first subscript list. 

Creates and buys temporary. 

Processes references defined by iSUB. 

Tests for end of second subscript list. 

Outputs first-list subscript and tests for end of list. 

Tests whether dictionary reference is constant or integer variable. 
Stacks parameters for recursive entry to DEFSUB. 

Returns to MASCAN or SySCAN. 

Tests whether second-list subscript is simple dictionary reference. 
Checks space in output text block. 

Initializes text blocks and pointers, gets scratch storage. 

Scans source text for references defined by iSUB. 

Moves text from source to output. 

Scans subscript lists. 

Scans subscripts. 

Scans subscript. 

Replaces iSUB by corresponding subscript or temporary. 


._j 
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• Chart 05. Translator Locrical Phase Flowchart 
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and Routine Directories 


Chapter 3: Flowcharts, Tables 


185 



Chart IA. Phase IA Overall Logic Diagram 
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• Chart IG. Phase IG Overall Logic Diagram 
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• Chart IK. Phase IK Overall Logic Diagram 
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♦GNEOP INTO TEXT* 
♦AND TABLE SCTRT* 
♦INTO TEXT BLOCK* 

* STORAGE * 


LOAD PHASE IL ♦ 


1 **** 
*IL ♦ 
->* A2 
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• Chart IL. Phase IL Overall Logic Diagram 


Al**** 

XLA2 


***A2**+**+* 


•••••B2********** 

♦ GET SCRATCH • 
•STORAGE ARC SET* 
♦ FUNCTION TABLE • 

* BO INTER • 


BASROU 

•••••C2********** 
•SET POINTERS TO* 
•RESTED FUNCTION* 



OBTEST 

•••••G2********«* 
• PET TEXT BLOCK * 
♦STORAGE FOR USE* 
• BE PHASE IN. * 
•SET POINTER TO * 


OINTI 

•*••* 


• *•• 
•IN « 
->* A2 
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Chart IM. Phase IM Overall Logic Diagram 


• B2 ♦-> 

* • 

GNTRID 

••»»*B2********** 

* SCAN FOR * 

* PROCEDURE, • 

* FUNCTION, • 
•INVOCATION, OR • 
•END OF PROGRAM * 


**** * 02 * •*•***•♦* 
•IDENTIFY LOWEST* 

• LEVEL • 

• INVOCATION * 

•STACKING START • 
*CF OUTER LEVELS* 


• **• 

* « 

* E2 • 

• • 

**•• 

• *. 

E2 *. 

, • *• 

.* IS *. YES 

*. FUNCTION .* 

•.BUILT-IN .* 


GNBIFH 

*••••£»»»•**»•• 

• ACCESS 

• BUILT-IN 
>* FUNCTION 

• TABLE ENTRY 


GNPLIS, 


OF FANIL? 
MEMBER 
DESCRIPTIONS 


YES .* IS IT *. 
* . PL/I GENERIC^, * 

"*. ,*' 


•CHECK ARGUMENTS* 

• FOR CORRECT « 

• NUMBER • 




NO 




< ■ 

GNARID 


*«***G2+ +++**+*** 

*****G4*« 



• IDENTIFY AND 

* RESOLVE 


•CHECK ARGUMENTS* 
•FOR VALID TYPE • 


•••**J1********» 

* CHECK FOR 

* ONE AND ONLY 

* ONE AGREEMENT 


GNFM3 V 

•••**K1*»******** 
REPLACE * 

ORIGINAL ♦ 

REFERENCE •- 

IN TEXT * 


GNF027 V 

*****B2********** 

*de&c£?pt?on l in * 

— >*TEXT FOLLOWING • 

* FONCTIONPRIME * 

* TRIPLE * 


GNF0« 

J2 *. 

.* MAS ♦. 

. » FUNCTION < 
*. INVOCATION 
NESTED 


*. 


+ . * ♦ 

* NC 

I 

***• 

* * 

• B2 * 

* « 

• •** 


.* 


*****J3*« ******* 
•RESTORE POINTER 
•TO NEXT LOWEST 
>* LEVEL OF 
* INVOCATION 


IS *, YES 

FUNCTION .* 

. GENERIC .* 


GNB08 

* * * * ♦ J 5 ***** • 

* SELECT 

* RELEVANT 

>• FAMILY 

* MEMBER 


GNB1S V 


* PLACE RESULT * 
•DESCRIPTION IN ♦ 
‘TEXT FOLLOWING *<- 


••K5******* 
REPLACE 
ORIGINAL 
REFERENCE 
IN TEXT 
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Chart IT. Phase IT. Overall Logic Diagram 


• *•• 

• • 

• B2 *-> 


•♦•♦♦B2********** 



• SCAN TEXT 


• FOR RELEVANT 


♦ TRIPLES 





B3 *. 

. • HAS * . 

. • END OF ♦ . YES 

->*. PROGRAM BEEN . ♦ 

*. POUND .♦ I 


C2 ♦. 

. ♦ WAS ♦ 
. ♦ FUNCTION 
MARKER 
♦ . FOUND 


►.NO * * 

.* >* 92 * 

► ♦ * 


* ♦ 

* D2 *-> 

* * 

PGFUNC 

* 

* ALTER 

* FUNCTION 
♦NESTING STATUS 


MODIFY 
TMPD' S 
IF NECESSARY 


♦ ♦♦* 

* ♦ NO . 

* B2 ♦< ♦. 

* * A 
♦ **♦ I 


.♦ WILL *. 

* IN-LINE < 
CODE BE 
* . GENERATED. < 


• *** *P3********* 

* 

* SCAN TEXT 
>* FOR BUY/ 

♦ BUYS TRIPLES 


.* WAS *. ♦ *** 

.* NESTED *. YES * * 

. FUNCTION .* >* D2 * 

•.DETECTED .* * * 

*. .♦ MM 

*. .* 

* NO 


PGBUYS .*. 

H3 ♦. 

.* IS *. ♦•*• 

.* TEMP. A *. NO * ♦ 

*. CHAMELEON .* >♦ B2 * 


•*#**j 3* ••••••*• 

* 

• DELETE BUY/ 

* BUYS TRIPLES 


♦ DELETE 

• ASSIGNMENT 
->* INVOLVING 

* CHAMELEON 


* DELETE ALL 

* OTHER 

* REFERENCES TO 
•THIS CHAMELEON 
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Chart IX. Phase IX Overall Logic Diagram 
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Chart JD. Phase JD Overall Logic Diagram 


♦ INITIALIZE • 

* POINTERS ETC. * 

• GET SCRATCH * 
•CORE FOB STACK • 


see 

• 

aaEiaaaaaaaa*a 

a 

E2* ’♦• 

. a a. 

a 

END OF • 

.a is THE ♦ . YES 

-->♦ 

a 

a 

PROGRAM •— 

a 
a 

>a # STACK EMPTY .♦ 

a, .♦ 

a. .* 

aaa 


a. .a 
♦ NO 

1 


SCANT 

•••••Cl******* 

* SCAN TEXT 

* FOR CONCAT 
* OR PREFIX 

* TRIPLES 


MORTXT 

••••*D2* ********* 

« GET NEXT « 
•BLOCK IN CHAIN,* 


WINDUP 

•****E3* *»*•••*•• 

* RELEASE * 

* SCRATCH CORE * 

>♦ AND * 

•RETURN CONTROL * 


***** 
*JI ♦ 
* Al* 



►♦aapiaaaaeaaaaa 

F2 a. 

OUT V 

eaaaeF3a*aaaa*aa* 

a 

a 

a 

END OF ♦ 

. * *. 

.♦ IS a. NO 

a a 

a POT OOT ♦ 

-->♦ 

EXPRESSION a— 

>♦. THE STACK .a 

a . EMPTY . • 
a. .♦ 

•• . * 

>• MESSAGE * 

a 

a 

a 

a 

a AND ABORT • 
a a 
aaaaaaaaaaaaaaaaa 


a YES 

CONCAT 

G3 ♦. 

a 

a 

— >• 

a 

a 

CONCATENATION *— 

♦ROUTINE CHECKS * 
>*OPERANDS DICT. * 

.* BOTH *. 

>a . CONSTANT . ♦ 

a 

a 

a 

a 

♦ ENTRIES ♦ 

a a 

a. STRINGS ,♦ 

♦ . .* 


STAKOP 

♦♦•♦•C5********* 
♦»•• » OPERAND 

« • • STACKING 

* C5 * >• CONTROLLING 

• * * ROUTINE CALLS 

• •*• • 


UNSTAK 

•••••OS** ••*•••• 

• HOVE RESULTS 

• FROM THE STACK 

• INTO TEXT . 

• ABORT IF 

• STACK EMPTY 


TRYFLG 

•*•••£5********* 

* TEST FLAG 

* BITS WHICH 
•CONTROL STACKNG 

* ABORT IF 

* STACK FULL 


• UPDATE TEXT 
-• POINTER RESET 

• TFLAG TO ZERO 


T u/nv-nifiiMib. 

* AND MAKE NEW 
>* DICT. ENTRY 

* FOR RESULT 


->* 


•****G5** *••»••< 

♦ NULL TRIFLE, 

* PUT REF IN 
STACK TEMP. 

♦SET SFLAG * 6l 


aa 

a 

*aaH3aaaaaaa< 

aa 

a 

aaaa 

a 

ZERO STACK 

a 

a • a 

>♦ 

a 

TEMPORARY 

a~ 

>a C5 a 

a a 

a 

aa 


a 

aa 

aaaa 


— >• UNARY PREFIX 


•ROUTINE CHECKS 
>• OPERAND'S 
♦ DICT. ENTRY 


J3 *. 

* *. 

NUMERIC *. YES 


• >* . CONSTANT 


SET SIGN 
AND MAKE NEW 
DICT. ENTRY 
IF MINUS 


* BUIL iMrLt, * 

* PUT REF INTO * 
>* STACK TEMP. » 

•SET SFLAG = 62 * 


•••••Kl**« «**••* 

* INERT 

->* NON-PRODUCTIVE 

* TRIPLE 



-4 

***• 

• * 

* C5 • 

* * 
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Table IA. Phase I A Translator Stacker 


1 

| Statement or Operation Type 

L 

(Main Processing! 
j Routine j 
j. j. 

Subroutines Used 


r 

| Scans source text 

T 

j ESCAN 

T 

J None 

-j. 



j Compares transfer vector 

j EACTNC 

j ECOO to 

EC10 


i 

| Stacks transfer vector 

L ...... 

| EACTNS 

| ESOO to 

ES2E 


I 

| Generates triples 

1 

j EGENR 

1 

| EGENR 2 , 

| EREPL, 

EGENR 3 , ENEWBL, ENOREP, 
ETRBMP 



Table IA1. Phase IA Routine/Subroutine Directory 


r t “ t 

} Routine/Subroutine | Function. | 

I- + j 

| EACTNC | Compares transfer vector. 

I I 

| EACTNS | Stacks transfer vector. 

I I 

| ECOO to EC10 | Provide comparison action for each operator. 

1 I 

| EGENR | Generates triples. 

I I 

| EGENR 2 l Generates triple for top stack operator, with blank first operand, 

j [then deletes the operator from the stack. 

I I 

|EGENR3 | Generates triple with two blank operands. 

1 I 

| ENEWBL | Obtains and chains new text block for output, resets output pointer. 

| ENOREP | Deletes top stack operator, flags new top operand as the result of 

| | the triple just generated. 

| EREPL | Replaces top stack operator by its prime, to indicate end of a list 

| jof function arguments or subscripts. 

1 I 

jESCAN | Scans source text. 

I I 

jESTCAC | Places operand in stack. 

JESOO to ES2E j Handle stacking of operators. 

|ETRBMP j Increments output point over one triple if end of text block is 

found. 
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Table IG. Phase IG Translator Pre-Generic 

r : t t 1 

j {Main Processing! | 

| Statement or Operation Type j Routine j Subroutines Us eel | 

I f + ^ 


j Scans text for BUY aggregate 
j argument dummies, end-of-block, and 
|end-of-program triples 

i ...... ... ......... 

j GS1 
'1 

1 

j. 

1 fr, : 
1 

1 

BR, TRF1, GS12 


r 

| Obtains next text block 

j GS12 

| None 



1 

| Transfers text to output block 

j TRF1 

j None 



| Transfers text skeletons to output 

i ._ 

j TRF2 

..j- 

1GS1, 

J. 

TRF1 


1 

(Stacks and unstacks information on 

J encountering function and function 
j triples 

i _ .... .... 

IfR, FRP 

1 

1 

a 

T 

| None 

1 

1 

-j. 



r 

| Inserts assignment statement for 
j aggregate argument dummies 

i " 

| BR 

1 

.X_ 

icsi, 

[ 

TRF2 



Table IGl. Phase IG Routine/Subroutine Directory 

r t 

| Routine/Subroutine | Function 

t + 


| 6R 

I 

| BRl 

I 

| BR2 

I 

| BR3 


Inserts assignment statements for aggregate argument dummies. 
Transfers point for IGNORE triple. 

Inserts assignment into text. 

Makes new dictionary entry for temporaries. 


I 


~\ 

I 

H 


| BR4 

I 

| FR f FRP 

I 

I 

| GS1 

I 

I 

j GS12 

I 

|TRF1 

i 

|TRF2 


Processes second BUY. 

Stack and unstack information on encountering function and function* 
triples. 

Scans text for BUY aggregate argument dummies, end-of -block, 
end- of -prog ram triples. 

Chains to next text block on encountering an end of block marker. 
Transfers text to the output block. 

Transfers text skeletons to the output block. 


L. 


.i 
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Table IK. Phase IK Translator Pre-Generic 


Statement or Operation Type 


| Initializes phase and obtains text 
| block storage for routine GNEOP 
| (called by main generic phase), for 
j translate table SCTRT used by the 
j expression analyser and for nested 
j function stack 

|Moves routine GNEOP, and table 
j SCTRT into text block storage 

j Loads Phase IL and transfers 
{control to it 

i . 


Main Processing 
Routine 


Subroutines Used 


■H 


ENTER 


None 


MOVETT 


+ 


None 


H 


•H 


LOADIL 


None 


j 


• Table IL. Phase IL Translator Pre-Generic 


Main Processing 
Routine 


Statement or Operation Type 


Subroutines Used 


Initializes phase, qets scratch 
storage and sets pointer to 
function table 


3EGIL 


None 


h- 


^BASROU 


H 


Moves function table into scratch 
storage and sets pointer to nested 
function stack area 


None 


•H 


Loads modules IM and IN and sets 
base for expression analyzer code 


BEGIN 


None 


Gets text block storage for use by 
Phase IM. Sets pointer to it. 
Moves constants into scratch 
storage and sets pointer to first 
constant. Transfers control to 
Phase IM 


GETEXT 




None 


■H 


._j 


Table IM. Phase IM Translator Generic 

r T — r 1 

j | Main Processing! | 

| Statement or Operation Type | Routine j Subroutines Used j 

| + + ^ 


j Selects function for processing 

j GNFUNC 

i .... 

| GNXTRP 




_ _ j 

| Selects generic procedure 

T 

| GNPLIG 
j 

| GNDRTA, 

GNXTRP, 

GNFMID 


1 

r — 

| Selects generic Library routines; 
{determines function result 

1 

1 

{gnbifh 

1 

1 

1 

1 

{ GNARID , 
| GNGNCR, 

1 GNSBAR, 
j GNSFMS 

-j- 

GNCBEF, 

GNPRSC, 

EXPANL, 

GNCACI , 
GNSACH, 
GNSAPR, 

GNCTBI , 
GNSAPC , 
GNSBRT , 


j. - — 

| Selects chameleon dummy and inserts 
{it in relevant dictionary entry 

T J 

| GNCHAM 

1 

4 

j GNXTRP, 

j 

EXPANL 



■- 1 

! Controls scan of text — branches 
j to processing routine 

j EXPANL 

1 

.1 

j ARITH, 

1 

LST1, SUBSPT, ASSIGN 

1 
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r t- 

| Routine/Subroutine | 


• Table IM1. Phase IM Routine/Subroutine Directory 

Function 

(Calculates type of result of arithmetic operation (except *♦). 
(Returns to calling phase with result. 

| Controls scan of text — branches to processing routine. 

Identifies argument of built-in function and converts it to valid 
type, if possible. 

Selects generic Library routine; determines function result. 

Selects relevant family member. 

Sets up result type of a built-in function. 

Checks and converts a decimal integer. 

Standardizes argument code byte to a form for generic selection. 
Selects chameleon dummy and inserts it in relevant dictionary entry. 
Converts from decimal to binary. 

Analyzes dictionary type. 

Forms pointers and branches to routine GNEOP in text block storage. 
Processes end- of- block marker. 

End of program routine. Frees blocks and releases control. 
Identifies family member. 

Selects function for processing. 

Checks for nested function situation. 

Sets up result type of a PL/I function. 

Replaces original reference in text. 

General conversion routine. 

Forms entry relating to particular invocation. 

Forms table of family member descriptions. 

Selects highest mode, scale and precision of variable argument list. 
Performs special argument check. 

Calculates scale and precision of a function result. 

Processes SUBSTR function and pseudo- variable arguments. 


j ARITH (IN) 

| 

| ASSIGN (IN) 

| 

| EXPANL (IN) 

j< 

| GNARID (IP) 


1 GNBIFH (I?) 


| GNB08 (IP) 


|GNB16 (IP) 


| GNCACI 

1 

| GNCBEF 


| GNCHAN 


| GNCTBI 


| GNDRTA 


| GNEND 


| GNEOB 


j GNSQP 


|GNFMID (IQ) 


1 GNFONC 


| GNF04 


JGNF027 


J GNFM3 (IQ) 


| GNGNCR 


| GNL06 (IQ) 


| GNPLIG (IQ) 


| GNPRSC (IP) 


| GNSACH 


| GNSAPC 


IGNSAPR 
l 
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Table IM1. Phase IM Routine/Sub routine Directory (continued) 

r r 

| Routine/Subroutine | Function 


r 

j GNSBAR 

j 


j Handles a subscripted argument. 

• 

| GNSBRT 

1 

| 

(IP) 

1 

| Examines all three arguments of SUBSTR and calculates the resulting 
jtype exactly. 

i 

| GNSFMS 

1 

1 

(IP) 

1 

| Replaces references to SUBSTR in text by a reference to another 
j entry givinq detailed information about the arguments. Places a 
j description of the resulting string in the text. 

I 

| 

| GNTRID 

l 


1 

| Scans source text. 

I 

j GNXTRP 

i 


I 

|Gets next triple, 
j 

J LST1 (IN) 

i 

j Calculates type and length of result of string operation. 

i 

j SUBSPT 

L 

(IN) 

1 

|Adds type of array to stack. 


-1 

I 

H 




Table IT. Phase IT Post-Generic Processor 


Statement or Operation Type 


| Main Processing! 
j Routine j 


Subroutines Used 


-H 

I 

I 

-H 


Scans source text 


j PGTXSC 


+■ 


j PGT01 # PGEOB, PGEOP 


Analyzes type of function detected jPGFUNC 


| None 


Completes function handling 


I PGFNCP 


PGNEXT 


Detects 'chameleon* temporary |PGBUYS 

references and deletes BUY and BUYS | 
triples where possible j 


PGBUY 


•H 


Deletes 'chameleon* reference in an|PGPASS 
assignment triple and alters the j 
argument triple to indicate an j 

intermediate result 


None 


■H 


Deletes all other references to 
'chameleon* temporaries where 
applicable 


| PGFNCM 


j PGBYAS, PGSELL 


._J 
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Table ITl. Phase IT Routine/Subroutine Directory 


j Routine/Subroutine j 


Function 


j PGASS 

j Deletes ’chameleon' assignments. 

i 



| PGBYAS 

1 

| Processes 'Buy Assignment* triples. 

i 



| PGBUY 

1 

(Processes BUY triples. 

1 



| PGEUYS 

1 

(Processes BUYS triples. 

i 



| PGEOB 

I 

| Deals with End of Text Block conditions. 



| PGEOP 

1 

(Processes end of program marker. 

i 



J PGFNCM 

1 

(Replaces 'chameleon' reference by an intermediate result 

I applicable . 

1 

where 


| PGFNCP 

1 

(Processes function prime marker. 

1 



| PGFUNC 

1 

(Analyzes function, and determines the type of processing 

I 

required. 


| PGNEXT 

1 

(Gets the next triple in source text. 

i 



| PGSELL 

1 

(Processes SELL triple. 

i 



| PGTXSC 

I 

| Scans text . 

i 



| PGTO 1 

( 

(Determines action to be taken for a significant triple. 




Table IX- Phase IX Pointer and Area Checking 


Statement or Operation Type 


| Main scan routine 


|Main Processing! 
j Routine | 

4 + 

1 BUMP j TEST f ERASER 

_JL X 


Subroutines Used 


H 

I 

-_J 

— n 


Table 1X1. Phase IX Routine/Subroutine Directory 


r T - 

| Routine/Subroutine | 


Function 


[bump 

I 

| TEST 

1 

| ERASER 
L 




4 


| Scan routine. 

I 

1 Tests operands for pointer and area data types 

I 

| Processes bad statements . 


.—j 
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Table JD. Phase JD Constant Expression Evaluator 

r ’■ 

1 

| Statement of Operation Type 

T T 

|Main Processing! 

( Routine | 

_ X -L 

Subroutines Used 

j 

r " 

(Initializes phase, gets scratch 
| etc. 

i INITl 

1 

T 

( None 

1 

.j. 


1 

t 1 

(Scans text, for constant triples 

j SCANT 

j MORTXT, 

PREFIX, CONCAT 


r 

| Handles stacking/unstackmg of 
| operands 

j STAKOP 

1 

j UNSTAK 

1 


^ 




Table JD1. Phase JD Routine/ Subroutine Directory 
| Routine/ Subroutine | 


Function 


^ 


CONCAT 

INITl 
| MORTXT 
[OUT 

PREFIX 

SCANT 
STAKOP 
i TRYFLAG 
ONSTAK 
UPTXT 
| WINDUP 

L 


Detects constant string operands, performs concatenation, makes new 
disk entry, and puts ref. in a slot for stacking. 

Gets scratch core for the stack, initializes slots and switches. 

[Gets next text block, resets pointer. 

Puts out error message and aborts compilation if stack is not 
emptied. 

[Detects unary prefixed constant, makes new list entry and puts ref. 
in a slot, for stacking. 

jwain scan routine. 

| Push down stack handler. 

Tests if stack is full, and if so, aborts. 

Moves entry from the stack. 

I 

[Updates text pointer. 

Releases scratch core and returns control to the control phase. 




._j 
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Chart 06. Aggregates Logical Phase Flowchart 


•STRUCTURE JI* 
•-♦-*-*-*•.*-♦-♦-♦ 

* STRUCTURE * 

* PREPROCESSOR * 


» STRUCTURE * 
♦PROCESSOR SCANS* 
♦ DATA CRAIN * 


*• .* 

♦ NO 

L *«*» 

♦ 07 ♦ 
>* A1 ♦ 


**•• 

♦ 07 * 
->* A1 ♦ 
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Chart JI. Phase JI Overall Logic Diagram 


*****&!********** 
♦ * 

♦ LOAD IEMJJ ♦ 

♦ MOVE CONTENTS * 

♦ AND RELEASE • 


*****B1*« ♦*♦***♦* 


♦♦♦♦*B2********* 


•***BU*** ****••• 


***•***•♦ 


->♦. LAST CHAIN 


••••Dl********** 


♦♦♦♦D2* ♦*♦♦♦♦♦♦ 


****El*i******** 

* 

PUT ITEM * 

ON TEMP *< 

CHAIN 2 * 


+ + + + *■£ 2 + + ******+* 


NO .♦ IS ♦ . 

♦. ITEM DATA .♦ 

♦.VARIABLE .♦ 


♦♦♦♦F2 ♦♦♦♦♦♦♦♦♦* 

PUT ITEM ♦ 

ON TEMP * 

CHAIN 1 ♦ 


****F4 ********** 


****F5» ******** 


**** .* ♦. 

♦ ♦ NO .♦ STRUCTURE ♦. 

* t)l ♦< r +. OR ARRAY .♦ 


♦. ADJUSTABLE 


*****GS« ••****♦* 
* 

♦ PUT STRUCTURE 
->* ON CORRECT 

♦ AUTO CHAIN 


♦ . ADJUSTABLE .♦ >♦ D1 ♦ 

*. .# * * 

*. .* ♦*** 


♦»***J2*** ♦**♦♦•♦ 
• * 

♦ MAKE ENTRY ♦ 

♦ FOR LIBRARY ♦ 

♦ ROUTINE ♦ 
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Chart: JK. Phase JK Overall Logic Diagram 


SCAN DATA 
->♦ CHAINS FOR 

STOP AGE ITEMS 


Jj 


<— 1< — *• 


X 

♦ A1 

* •** 


♦JP « 
• Al« 
♦ ♦ 


->* MAKE A DVD 


l- 


• Ml 
• « 
• A1 • 


* *** *c2* *♦•♦♦ 

* 

♦ 

>♦ GET BASE 


. • HAS ♦ . 
. ♦ BASE BEEN 
->♦. PROCESSED 


** ** 


D2 


IS ♦ . 

* ♦ YES .♦ BASE ♦ 

► A1 ♦< ♦.SUITABLE FOP 

* ♦ ♦. DIRECT .♦ 

♦♦*♦ ADDRESSING 


. ♦ ANY ♦ . N 
->♦ . ADJUSTABLE . ♦- 
♦. EXTENTS .♦ 


***«*£ 3********i 
* 

* 

->♦ MAP STRUCTURE 


♦ * 

♦ F3 ♦— n 

•••••• 1 


*•#* .* 

* ♦ . ♦ 

* F2 ♦ >♦. TEMP 


****«F3 ********* 
* 

* 

->♦ MAKE AN RDV 

* 

* 

**************** 


**** .* * 

* ♦ YES .* IS RDV 

* F3 ♦< ♦. REQUIRED? 


ADJUSTABLE? .♦ n 

J 


MAKE DVD 

*************** 


*****H3********* 

♦ GENERATE 
♦LIBRARY CALLING 

♦ SEQUENCE 


F2 • 

• * * * 


.FIXED SCALAR .♦ n 

-v,-- 1 


***• 

♦ ♦ 

* FH * 

* ♦ 


*****j2* ********* 
* * 

♦ MAP ARRAY ♦ 

* * 

* * 

***************** 

**** 

♦ * 

->♦ E4 ♦ 

* * 

**•* 


ALVACI 

♦♦♦♦♦K3** ♦•♦♦♦♦♦♦ 
♦ GENERATE CODE ♦ 
♦TO RELOCATE BY ♦ 
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♦TO RELOCATE BY ♦- 
♦VDA ACCUMULATOR* 


♦ ♦ GENERATE CODE 

K5 ♦ >♦ TO SET ITEM 

♦ ♦ADDRESS IN POV 


**** 

* * 
♦ A1 * 


**** 

* * 

♦ FU * 

♦ * 
**** 


Chapter 3: Flowcharts, Tables, and Routine Directories 


203 



• Chart JP 


Phase JP Overall Logic Diagram 
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Table JI. Phase JI Aggregates Structure Processor 


Statement or Operation Type 


T T 

Main Processing 
Routine 


Subroutines Used 


f- 


To re-order the STATIC AUTOMATIC 
and CONTROLLED chains and to 
process structures 


SCANA 


MAP, MAP A 


To scan down the COBOL chain for 
COBOL-mapped structures 


SCAN 


MAP 


-H 


To transfer items from the COBOL | RECHAN 
chain to the appropriate AUTOMATIC 
chain 

^To transfer control from IEMSI to IterMIN 
IEMJM 


None 


None 


1 

I 

-I 


To map COBOL structures 


MAP 

MAPA 

^NXTRFl 

*NXTRF2 


NXTRFl , NXTRF 2 
+ 


To check non-COBOL structures for 
constant length 

To find the next member of a 
structure 

To find tne next element of a 
structure 


None 


None 


None 


I 

I 

^ 


Table JI1. Routine/ Subroutine Directory 
| Routine/Subroutine | 


Function | 


| MAP 

I 

j MAPA 
I 

\ NXTRFl 

I 

| NXTRF 2 

I 

I RECHAN 

I 

1 

j SCAN 

I 

j SCANA 

I 

I 

| TERMIN 


To map COBOL structures 

To check non-COBOL structures for constant length 
To find the next member of a structure 
To find the next element of a structure 

To transfer items from the COBOL. chain to the appropriate AUTOMATIC 
chain 

To scan down the COBOL chain for COBOL-mapped structures 

To reorder the STATIC, AUTOMATIC, and CONTROLLED chains and process 
structures 

To transfer control from IEMJI to IEMJM 


l 


1. 


— j 
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Table JK- Phase JK Aggregates Structure Processor 


j Statement or Operation Type 

h 


| Scans AUTOMATIC, STATIC, and 
j CONTROLLED chains 


Main Processing 
Routine 


CHNSCN 


Subroutines Used 


ADRDV , CHKDEF, MKDVD, MKRDV, 
PROCDT, PROCST, SETBRF, TERMWS 


•H 


| Processes DEFINED items 


CHKDEF 


CMPIL1, INOBJ, PROCDT, PROCST, 
STBASE 


k 

| Processes structures (calculates 
| offsets, multipliers, sizes, 

| alignments and padding; generates 
| object code) 


PROCST 


CMPIL1, INOBJ, ELSIZ 


j Processes arrays (calculates 
| multipliers and generates object 
j code 

j Calculates storage offsets for 
j adjustable items in structures 

j Calculates storage offsets for 
j adjustable arrays 

¥ 

(Calculates storage offsets for 
(adjustable strings 

(Generates code to initialize string 
(dope vectors for arrays of varying 
j strings in structures 

|- 

(Generates code to initialize string 
(dope vectors for varying, 
j non- structured arrays 

h 

(Generates code to calculate the 
(starting address of storage for 
(overlay defined items 

h 


•H 

■H 

•H 

-H 

-H 


PROCDT 


CMPIL1, INOBJ, LOADCN, SP5U 


PS25 


CMPIL1 


ALVACA 


~4 


CMPIL1 


+ 

CMPIL1 


ALVACI 


SVARY 


CMPIL1, INOBJ, IPDV, VOBJC 


VOBJC 


CMPIL1, INOBJ, IPDV 


STBASE 


^CMPILl 


^ 


H 

-H 

■H 

-H 


[Adds text skeletons to the output 
stream 


CMPIL1 


None 


¥- 




| Makes dictionary entries for dope 
| vector descriptions 


MKDVD 


ELSIZ 


h 

| Makes dictionary entries for record 
(description vectors 


MKRDV 


MKCNST, CMPIL1 


h 




j Generates code to set the address 
j in a record description vector at 
(object time 

¥- 


ADRDV 


INOBJ, CMPIL1 


[Calculates the length and alignment 
of scalar data items 


ELSIZ 


None 


*+ 

| None 


H 

I 

—j 


jsets offsets for BASED variables (BASED 
L L 
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| Routine/Subroutine | 


Table JK1. Phase JK Routine/Subroutine Directory 

Function 

Generates addressing code for AUTOMATIC RDVs. 

Calculates storage offsets for adjustable arrays. 

Calculates storage offsets for adjustable strings. 

Sets offsets for BASED variables. 

Processes DEFINED items. 

Adds text skeletons to the output stream. 

Determines size of storage required for structure base elements. 
Initializes object code statements. 

Generates code to set up primary dope vectors. 

Generates object code to load object registers with constants known 
at compile time. 

Makes dictionary entries for DVDs. 

Makes dictionary entries for RDVs . 

Gets the next structure base reference. 

Processes arrays. 

Processes structures. 

Calculates storage offsets for adjustable items in structures. 

Scans AUTOMATIC, STATIC, and CONTROLLED chains. 

Sets the reference to the current entry type 1. 

Sets the dynamic dope vector size for non-ad justable structures. 
Calculates base element multiples. 

Generates code to initialize starting address storage for overlay 
defined items. 

Generates code to initialize string dope vectors for arrays of 
varying strings in structures. 

Terminates object code. 

Generates code to initialize string dope vectors for varying, 
non- structured arrays. 


| ADRDV 

1 

(JL) 

|< 

i 

j ALVACA 

■ 

(JL) 

j 

1 

j ALVACI 

1 

(JL) 

I 

1 

j BASED 



1 

j CHKDEF 

(JM) 


1 

j CMPIL1 

i 

(JL) 


1 

j ELSIZ 

i 


j 

1 

j INOB J 

i 

(JL) 


1 

| IPDV <JM) 

i 

1 

| LOADCN 

1 

(JL) 

I 

1 

JMKDVD 



1 

JMKRDV 

(JM) 


l 

j NXTREF/NXTRF1 

i 

(JM) | 

l 

| PROCDT 

i 

(JM) 


| PROCST 
j 



1 PS25 



1 

jCHNSCN 

1 

(JL) 


1 

| SETBRF 

(JL) 


1 

j SETDVS 
■ 



1 

| SP54 
■ 



1 

j STBASE 
1 

(JM) 


1 

| SVARY 

1 

(JL) 


1 

j TERMWS 
1 

(JL) 


1 

IVOBJC 

1 

L 

(JL) 



i 

I 

H 


—j 
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Table JP. Phase JP Translator Defined Check 


i 

| Statement or Operation Type 

|Main Processing! 

j Routine j Subroutines Used 

-J. -L 

J 

| Scans DEFINED chain; checks 

J validity 

i IEMJP 

1 

_ i 

(GETCLS, GETLTH, STRCMP 

1 

X 

1 

| Checks that two structure 
(descriptions are the same and that 
jthey may be validly overlaid 

j STRCMP 

1 

1 

-X _ _ 

T 

| None 

1 

1 



Table JP1. Phase JP Routine/Subroutine Directory 
[Routine/Subroutine | Function 


I GETCLS 


I 

j GETLTH 


| IEMJP 
j JP8 

I 

j JP20 

I 

| JP200 

I 

j JP540 

I 

j JP541 
\ 

| JP542 

I 

j JP543 

I 

j STRCMP 




(Analyzes structure descriptions, and checks that all elements are of 
the same defining class. 

Obtains length of string or numeric field from associated dictionary 
entry. 

Controlling scan of DEFINED chain; checks validity. 

Tests whether defined item is packed. 

Tests whether base defined item is adjustable. 

Tests whether item is a structure. 

Tests whether defined item is coded arithmetic. 

Compares base and defined item. 

Tests whether defined item is dimensioned. 

Tests whether base code is arithmetic. 

Compares structure descriptions. 




Table JZ. Module JZ Compiler Control 


j (Main Processing! 

| Function j Routine | 

[Reconstructs the phase directory |IEMJZ | RLSCTL, ZUPL, ZEND 

| for the second half of the compiler! j 


Routines Used 


I Entry to OS/360 : BLDL 
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• Chart 07. Optimization Logical Phase Flowchart 


****A1********* 


*****B1********** 

* KA* 

* UTILITY ROUT- * 
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*****D1********** 
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♦ -*-♦-♦-*-*-*-.*-* 
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♦VARS AND DO-MAP* 
♦TABLE CREATED ♦ 


•BUILDS USE LIST* 
•AND SUBS/REGION* 
* LIST * 


*****?!•*« ******* 
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•TABLE FROM SUBS* 

* /REGION LIST * 


****«G1* ********* 

* KN* 
*-♦-*-♦-*-*-♦-*-* 
♦INITIALIZATION ♦ 

* AND OFFSET • 

* REMOVAL • 


MATCH SUBS CODE* 
CREATE PATCH * 
FILE ♦ 


♦ CONSTRUCTS * 

• PSEUDO-CODE • 

* TRIPLES • 

***************** 


♦DO-LOOP CONTROL*- 


•♦♦•K2********* 


* REPLACEMENT 
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• Chart KA. Phase KA Overall Logic Diagram 
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* UNWANTED * 


CONVERT USERS 
S.A. TO 
ABSOLUTE 
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* UNLOCK DIRECT • 

* REF. POINTER • 
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* ♦ 

♦ POSITION * 
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♦START OF TABLE * 


n 

* I ♦♦** 

♦ V ♦ 


♦ FU *<-, 

* * I 

***♦ I f 


♦ POSITION * 
♦POINTER TO NEXT*- 
♦ENTRY IN TABLE ♦ 


*****p>3* ********* 

♦ * 

♦ LOAD END OF * 

->♦ TABLE RETURN *- 

♦ CODE ♦ 

♦ * 
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• Chart KA. Phase KA Overall Logic Diagram (continued) 


•****G2**««****< 

• POSITION 
->*CURRENT TRIPLE 
« POINTER 


•**»*H2* ******** 

« POSITION 
->*POINTER TO NEXT 
» TRIPLE 
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• CODE 
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• Chart KC. 


Phase KC Overall Logic Diagram 
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**** 
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**************** 


♦****G2* ******** 


E3 ♦. 

. * *. 
.* * 
—>*• ANY REORDER? 


**** 

* * 

* A1 * 

• * 
***♦ 
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•Chart XE. Phase KE Overall Logic Diagram 
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• Chart KG. Phase KG Overall Logic Diagram 
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• Chart KJ. Phase KJ Overall Logic Diagram 
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• Chart KN. Phase KN Overall Logic Diagram 
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• Chart KO. Phase KO Overall Logic Diagram 
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• Chart KT. Phase KT Overall Logic Diagram 
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•Chart KU. Phase KU Overall Logic Diagram 
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•Table KA. Phase KA Resident control Module 
re- 


statement or Operation Type 


h 

| Handles KTAB BLDC/T operations 

I 

t 

| Handles KTAB DR operation 
| Handles KTAB ULDR operation 


Subroutines Used 


+ 

1 Handles KTAB DEACT operation | KAHDAC 

j. + 

j Handles KTAB FREE operation j KAHFRE 

Handles KTAB SCAN operation for | KAHSCN 

| non-text tables j 


| Main Processing! 
j Routine j 

+ + ^ 

j KAHBLD j ZTXTAB, KAHLOK, KAHULK, ZUTXTC, 

| j KAHERR 

+ + ^ 

j KAHMDR | KAHERR, ZTXTAB, Z ALTER, KAHULK 

+ (• ■( 

| KAHUDR j KAHULK 

^ 


| KAHULK 

4 

| KAHERR, ZALTER 

| KAHERR, KAHLOK, ZTXTAB, KAHULK 

I 


-H 

I 

H 

I 

I 

-H 


| Handles KTAB SET/SET Z operations | KAHSET 

Y 1 

| Place save area stack, DTCAs and (KBSTUP(KB) 
j block list table in scratch storage! 


j KAHERR, KAHULK 
j None 


^ 


J 


•Table KA1. Phase KA Routine/Subroutine Directory 
r t 


1 Routine/Subroutine J 

Y + 

| KAHBLD ! 

I I 

! KAHDAC ! 

I I 

| KAHERR ! 

! I 

J KAHFRE | 

! 1 

i KAHLOK | 

i I 

(KAnMDR ! 


Function 

Handles KTAB BLDC/T operations 

Handles KTAB DEACT operation (non-text tables) 

Produces error message and aborts 

Handles KTAB FREE operation 

Locks a table entry 

Handles KTAB DR operation (non-text tables) 


! 



’ KAHSCN 

j KAHSET 

1 

| RAHTXT 

i 

| KAHUDR 

I 

| KAHULK 

I 

JKBSTUP (KB) 


j Handles KTAB SCAN operation (non-text tables) 

i 

| Handles KTAB SET/SETZ operations (non-text tables) 

(Handles all KTAB operations on text tables 
(Handles KTAB ULDR operation 
(Unlocks a table entry 

(Places save area stack, DTCAs and block list table in scratch 
j storage 


L. 


X. 



220 




•Table KC. Phase KC Do-Loop Specification Scan 


Statement or Operation Type 


Subroutines Used 


T T" 

(Main Processing! 

| Routine | 

h 1 + 

(General text scan { NXTRP * j SCAN (KA), DOLOOP, ONBLK 

| Sets ON mask for ON unit | ONBLK | SCAN (KA) 

I- + + 

(Initializes reordering scan after (DOLOOP (SCAN (KA) , EXANAS, CVEND, MOVE , 

(ITDO triple j j MOVER 

j. ■(■ 

(Analyzes expression in loop speci- (EXANAS 

j f ication j 

| Scans for ITDO nested in loop j RSCAN 

j specification j 

t 1 + 

(Completes reordering scan at end of (CVEND 
j loop specification j 

L X 


■H 


-H 


j SCAN (KA) , MOVER, RSCAN 


j SCAN (KA) , MOVER 

1 

— (. 

(SCAN (KA), RSCAN, MOVER, MOVET 

I 


H 


•Table KC1. Phase KC Routine/Subroutine Directory 


j Routine/Subroutine j 


Function 


H- 

| CVEND 


| DOLOOP 

I 

j EXANAS 

1 

| MOVE 

I 

(MOVER 

I 

(MOVET 

! 

(MXTRP 

I 

(ONBLK 

I 

j RSCAN 

I 

j SCAN (KA) 


Completes reordering scan at end of loop specification 

Initializes reordering scan after ITDO triple 

Analyzes expression in loop specification 

Puts triple into MOVE list 

Puts triple into REORDER list 

Moves REORDER list into text 

General text scan 

Sets ON mask for occurrence of ON unit 
Scans for ITDO nested in loop specification 


Scans text 


• Table KE. Phase KE Dictionary Scan and DO-Map Build 


Statement or Operation Type 


|Main Processing! 
j Routine j 
-+ f 


Subroutines Used- 


— i 

I 

I 


j 


•H 


j Initialization 

i . . 

j KEINIT 

f 

(KCDS, 

KESCAN, 

HTAB 

(Dictionary scan marking unsafe 
j variables 

j KCDSIN 

1 

Jhtab, 

1 

ZDICRF , 

ZDRFAB, ZDABRF 

j Scans text and passes control to 
(triple processing routines 

j KESCAN 

1 

- J_ — - _ . 

\ 

(ktab 

1 

X . 
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Table KE1. Phase KE Routine/Subroutine Directory 

Function 

Dictionary scan marking unsafe variables 
Creates a DO-Map entry 
Completes the DO- Map entry 

Produces termination error message and aborts 
Initialization 

Scans list of procedures and pointers 
Scans text calling triple processing routines 


r t- 

| Routine/Subroutine 1 

j. f-- T — — 1 

j KCDSIN 

I 

j KECDME 

I 

j KEDEND 

I 

j KEERRH 

I 

j KEINIT 

1 
I 
I 


KELKOP 


KESCAN 

i 

j KESTCK 
L 


| Makes entry in stack 




Subroutines Used 


• Table KG. Phase KG DO Examine Phase 

| (Main Processing! 

I Statement or Operation Type j Routine j 

|Main processing routine | KGMAIN | KGSCAN, KGSRGL, KGSORT, KGUSEN 

[Tests whether an ON-unit could be JKGOTST | KGSRGL 

j entered as a result of an interrupt! J 

joccuring at the triple being j J 

j considered J 1 

{Transfers control to appropriate j KGSCAN j KGERRR 

| triple routine | 1 

{Considers a variable for entry into j KGUSEL | KGUSEN 

J the USE list j j 

L L L 

•Table KG1. Phase KG Routine/Subroutine Directory 

Function 

[Deletes non-compiler- created temporaries from USE list 
Deletes unsafe variables from USE list 
Produces a termination error message and aborts 
[Main processing routine 


1 

I 

* 

I 

I 

I 

I 

4 


{ Routine/Subroutine J 


^ 

! 

J 
1 


| KGDEIT 

1 

| KGDELU 


J KGERRR 


| KGMAIN 


| KGNICE 


1 KGOTST 


(KGSCAN 


| KG SORT 


J KGSRGL 


| KGUSEL 


j KGUSEN 



Checks that a dictionary reference is for a real fixed binary scalar 
integer variable 

Tests whether an ON-unit could be entered from the triple being 
considered 

Transfers control to appropriate triple routine 

Sorts the USE list so that invariant variables appear first 

Makes an entry in the SUBS/REGION list 

Considers a variable for entry into the USE list 

Makes an entry in the USE list ^ 
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•Table KJ. Phase KJ Subscript Table Build 

| | Main Processing! 

j Statement or Operation Type j Routine | Subroutines Used 

[to build the SUBS TABLE from the |kJSB • {kJSRBXCH, KJSRCHKP, KJSRSOPC, 

| Subs/Region List and test the loop j | KJSRTDED, ZDRFAB, KTAB 

(initial, step, and limit for use inj | 

|BXLE and BXH code j j 


i 


1 


-j 


•Table KJ1. Phase KJ Routine/Subroutine Directory 


r T“ 

| Routine/Subroutine | 


Function 


^KJSB 


| KJSRBXCH 

I 

KJSRCHKP 
| KJSRSOPC 
! KJSRTDED 

i KJSRUSEL 
| KODECN 

| KONICE 
| KOPKSN 


~1 

I 

H 


| Builds SUBS TABLE from Subs/Region List and tests the loop initial, 

| step, and limit, for use in BXLE and BXH code 

I 

| Checks that current loop is optimizable for BXLE, BXH loop control 
I code 

Sets a series of flags stating the attributes of the expression 
being analyzed 

. 

Sets a series of flags stating the attributes of a given triple 
operand within the context of the expression analysis 

Sets the target DED in the dictionary entry for a constant to be 
used in BXLE/BXH code. If necessary, new data dictionary entries 
are created and the reference in text modified. 

Searches the given USE list for a given variable 

I 

| Tests a given dictionary entry for a REAL, FIXED, BINARY, SCALAR, 
INTEGER variable, or a BINARY or DECIMAL INTEGER constant 

(Tests that a given variable is REAL, FIXED, BINARY, SCALAR, INTEGER. 

Tests if a given dictionary reference is: 

1. a variable of precision less than 30 bits or 

2. a decimal constant of precision less than 8 digits or 

3. a binary constant of less than or equal to 30 bits 


—j 
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• Table KN. Phase KN Subscript Optimization 


h 


Statement or Operation Type 


T T 

Main Processing 
Routine 


Subroutines Used 


Sets up the physical phase KN data 
area, KNDATA in scratch storage. 
KNCODE, which is a group of lower 
level subroutines, is also moved 
into scratch storage. The scratch 
storage area is provided by KA. A 
scan is made of the chain of DO-map 
entries, and subroutine KNCLOF is 
called for each to remove offsets, 
and prepare potentially optimizable 
subscripts for matching. 


KNINIT 


KNCLOF 


Scans the subs entries of the 
subs-region table for the loop. It 
cleans up potentially optimizable 
code, removes offsets, accumulating 
the total offset in the spare 
operand of the appropriate subs 
triples, and calculates hash values 
for optimizable COMA*s. 

h 


KNCLOF 


KNCOMU, KNHASH, KNANAL, KNOPTY 


Accumulates hash total and computes 
hash for specified triple. 


KNHASH 


None 


h~ 




-H 


h 


Analyzes the type of triple operand 
and sets a return code value 
accordingly. 


KNANAL 


ZDRFAB 


Analyzes the type of triple operand 
and sets a return code value 
accordingly. 


KNOPTY 




Converts a decimal constant to I KNCOMU 

binary and multiplies it with a 
given binary value. An option may 
be specified to allow conversion 
only of the given decimal constant 
to binary. 


ZDRFAB 


^ZDRFAB 






J 


Table KN1. Phase KN Routine/Subroutine Directory 
| Routine/Subroutine | 

f + 


Function 


j KNANAL 

I 

\ 

j KNCLOF 

I 

I 

I 

| KNCOMU 

I 

| KNHASH 

I 

j KNINIT 

I 

I 

j KNOPTY 

L 


Analyzes type of triple operand and sets a return code value 
accordingly. 


t 

I 

\ 


Scans subs entries of subs-region table for loop. Cleans up 
potentially optimizable code, removed offsets, and calculates hash 
values for optimizable COMA*s. 

Multiplies decimal and binary values. 

Accumulates hash total and computes hash for specified triple. 

Sets up code and data areas in scratch storage, and scans chain of 
DO-map entries, calling KNCLOF to remove offsets. 


Analyzes type of triple. 


j 
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• Table KO. Phase KO Subscript Optimization 


Statement or Operation Type 


Main Processing 
Routine 


Subroutines Used 


Initialization is performed for the|KOINIT 
phase. The next DO-map entry in 
processing sequence is obtained and| 
put in scratch storage. Module KP 
and KQ are 1 loaded, and the 
Subs/Region Table is updated from 
the patch file. The iterative 
specification and DO-map are 
checked in order to amend iterative! 
specification. A subroutine is 
called to form a match chain in the| 
Subs/Region Table, once for 
Transforms and Invariants and once 
for comraoning. When end of DO-map 
is reached return is made to 
Compiler control 

The sindex number for the loop is 
set to zero. The routine looks at 
the DO-map entry and iterative 
specification triples and makes a 
patch over the ITDO and ITD* 
triples if BXLE/BXH is to be 
generated for the loop 

The match chain is processed and 
entries are made in "the patch file. 

The patch entries contain optimized) 
code for three types of 
subscript. Patches are also 
created for the BXLE/BXH code for 
optimized loop control 


ZLOADX, RELESE, 

KTAB (Macro routines in KA) , 
KNOPTM, KOBXCH, KPUPDT 


KOBXCH 


-H 


KOMTCH 


KTAB (Macro routines in KA) , 
KOSNDX, KOPTCH 


^ 

ZDRFAB, ZDICRF, 

KTAB (Macro routines in KA) , 

KOCVTX, KOSNDX, KOMAKC , 

KOPTCH, KOMCOM, KOMCHN, 

KOMOVE, KOSSB3, KOSSB2, K0SSB1 


Creates part of patch for I KOMCOM 

Transforms and Invariants. It is 
called from KOMTCH 

Makes an entry in the patch file | KOPTCH 
from the patch build area. Options 
are available to move the patch 
data to the patch build area before 
making an entry in the patch file. 

Entries are chained together if 
they are to be inserted at the same 
point in text. A PTCH triple is 
placed in text at the point of 
insertion. The overwritten triple 
is placed in the patch 


KOMOVE, KOPTCH 


+ 1 

KTAB (macro in KA) , KOMOVE, KOPCOM 




—J 
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• Table KO. Phase KO Subscript Optimization (continued) 


h 




Statement or Operation Type 


— + 


Moves the triple to be . overwritten 
into the patch and moves the patch 
into the patch file. The symbolic 
reference of the patch is moved to 
the PTCH triple in workspace. The 
triple in text is then overwritten 
with PTCB triple 


Main Processing 
Routine 


KOPCOM 


Subroutines Used 


KOMOVE 


-H 


—I 


The triples pointed to by the text | KOMCHN 
references in the Subs/Region Table 
elements in the current match chain 
are amended to refer to a value 
calculated in patch code. The 
chain is then deleted and all 
COMA's processed are marked in the 
Subs/Region Table as dealt with and 
optimized 


KTAB (macro routines in KA) 


Tests the type of triple at the 
address given and sets a return 
code accordingly 


KNTRTY 


■H 


none 


H 


Moves an item to the next available 
address in the patch build area in 
scratch storage 


KOMOVE 


none 


Allocates a sindex register. The 
sindex register counter is 
incremented, the sindex available 
counter is decremented and the 
symbolic register counter is 
incremented 


KOSNDX 


ZUERR, Z ABORT 


-I 


The first part of a subs list, con- 
sisting of the SUBS triple and the 
COMA's before the first matched 
triple, is moved to the patch build 
area. The SUBS is chanced to SSUB 
and a symbolic register number is 
placed in the second operand. A 
null value is inserted in the 
second operand of the COMA triples. 
All other triples are not moved 




KOSSBS 


KTAB (macro routines in KA) , 
KOSNDX, KOMOVE 


-H 


H 


Moves the last part of a subs list, 
consisting of the COMA's between 
the last matched triple and the 
SUB* triple, to the patch build 
area. The SUB* is changed to SSB' 
and all COMA triples have their 
second operand set to null value. 

No other triples are moved 


KOSSBE 


KOMOVE 


— J 
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• Table KO. Phase KO Subscript Optimization (continued) 


Statement or Operation Type 


T 

Main Processing 
Routine 


| Tests whether any operand in a list|KOCVTX* 
j of triples is a reference to a 
j control variable of the current 
| loop 


Y 

| The message 'Invalid input type V 
j to optimizing phase KO* is put out 

j Moves a subscript list into the 
j patch build area changing the 
j subs/sub ■ triples to SSUB/SSB*. 

| All matched COMA expressions are 
| copied with amendments as follows: 

| (1) References to the control 
| variable are replaced by references 
| to the step. 

| (2) All additive invariant parts of 
jthe expression are deleted, 
j All unmatched COMA expressions are 
j replaced by COMA - NULL 

j A subscript list is moved to the 
j patch build area with SUBS/SUB * 
j changed to SSUB/SSB* triples. All 
j matched COMA expressions are copied 
j except the dictionary references to 
jthe control variable which are 
j replaced by dictionary references 
| to the 'initial* elements. All 
j unmatched COMA expressions are 
j replaced by COMA - NULL 


+ 


Subroutines Used 
KTAB (macro routines in KA) , KNTRTY 


4 


KOEROR 


ZUERR , Z ABORT 


K0SSB3 


KOSSBS, KNTRTY, KOMOVE, KOSSBE 


KOSSB2 


KNTRTY, KOMOVE, KOMAKC, KOSSBE, 
KOEROR, KOSSBS 




Y 

jA subscript list is moved into the 
| patch build area with SUBS/SUB' 
j triples changed to SSUB/SSB* 
j triples. All matched COMA 
j expressions are copied. All 
j unmatched COMA expressions are 
j replaced by COMA - NULL 

j Produces a binary constant, if it 
j is possible, given as parameters 
jthe dictionary reference of two 
j constants in the operands of a 
j given triple. A dictionary entry 
jis made for the new constant, the 
j dictionary reference of which is an 
j output parameter. A return code 
lvalue is also given indicating 
| whether or not such a constant has 
j been created 

j A dictionary entry is obtained from 
jthe given dictionary reference and 
j tested to see if it is for a 
j decimal or binary integer constant. 

| If it is, the effective precision 
jis found and the constant is 
j converted to binary if necessary 


^KOMOVE, KOSSBE, KOSSBS 


KOSSB1 


KOMAKC 


KOTSTO, KNTRTY, ZDICRF, KOADDC , 
KOSUBC, KOMLTC 


■H 


^KOTSTO 


4 ^ 

ZDRFAB , KNCOMU, KOPREC 


._J 
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• Table KO. Phase KO Subscript Optimization (continued) 


Statement or Operation Type 


Calculates the effective precision 
of the binary fullword given 


Main Processing 
Routine 


KOPREC 


~+ 


Subroutines Used 


4 


none 


< 


A binary fullword result is 
obtained by multiplying together 
the two input binary values 


KOMLTC 


none 


A binary fullword result is 
obtained by adding together the two 
input binary values 


KOADDC 


■H 


none 


■H 


^ 


KOSUBC I none 


^KNCOMU t ZDRFAB 


A binary fullword result is 
obtained by the subtraction of the 
two input binary values 

k 

Converts a decimal constant to 
binary and multiplies it with a 
given binary value. An option may 
be specified to allow conversion 
only of the given decimal constant 
to binary 


+ 

KTAB (macro routines in KA) , 
KNSECO, KNTRMV, KNCHRG, KNCMPR, 
KNALRG, KNOMAC , KNMKVL, KOMTCH 


-H 


Scans the subscript lists of a 
DO-Ioop looking for matching COMA's 
or COMA - expressions which are 
possible candidates for 
transforming, moving out of the 
loop as invariants, or commoning 


KNOPTM 


Forward scans the Subs Table entry | KNSECO 
(equivalent to a backwards text 
scan) looking for the first group 
of COMA*s that are optimizable as 
indicated by a switch 

Analyzes the type of triple operand) KNANAL 
and sets a return code value 
accordingly 


^ 


+ 

none 


+ 

ZDRFAB 


Clears the match chain j KNOMAC 

Match area code is compared with | KNCMPR 
text. The start point, finish 
point, and length of matched code 
is passed back. Only complete 
COMA's or COMA - expressions are 
matched 

h + 

Text between specified triples is | KNTRMV 
scanned. Cleaned up triples are 
moved into scratch storage 


1 


KTAB (macro routines in KA) 

+ .j 

KTAB (macro routines in KA) 


+ < 

KTAB (macro routines in KA) , 

KNTRTY, KNANAL, ZTXTAB, KNCOMU 


J 
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• Table KO. Phase KO Subscript Optimization (continued) 


Statement or Operation Type 


A list of dictionary references of 
all variables in operands of 
triples in a scratch work area is 
made. The list is terminated with 
a halfword of zeros. A flag is 
also set if any of the variables in 
the work area are unsafe 


] A check is made to determine if the 
(given region entry is an end region 
| for commoning for the matched code 
jin the scratch work area 

l. 

| A check is made for region 
(boundaries between specified 
j subscripts 

j Controls the search through the 
j patch file for SSUB triples and the 
(subsequent processing of the 
(restricted types of expressions 
(found after the SSUB triples 

(shortened version of phase KJ. 
(Processes those triples following a 
(SSUB triple 

jThe USE list is searched to see if 
(the given dictionary reference is 
(contained in the list. A return 
(code is set depending on the part 
(of the USE list in which the 
( reference is found 

(Examines an operand of a triple and 
(sets flags in a code byte giving 
(the information required on the 
(operand during the analysis of the 
(expression within which it occurs 

t 

| The operands of triples following a 
| SSUB triple are examined to 
(determine the type of expression 
(under consideration 


Main Processing 
Routine 


KNMKVL 


KNCHRG 


KNALRG 


KPUPDT 


— (. 

| KTAB (macro routines 


KPSSUB 


KPUSEL 


+ 

KPSOPC I 


KPCHKP 


Subroutines 


KNANAL 


KTAB (macro routines in KA) 


in KA) 


4 

, KNCHRG j 


1 

, KPSSUB 


KTAB (macro routines 
ZDRFAB, KPCHKP 


in KA) 


| KTAB (macro routines 


in KA) 


ZDRFAB, KPUSEL 


KPSOPC 1 
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• Table KOI • Phase KO Routine/Subroutine Directory 

| Routine/Subroutine | x Function 


KNALRG 
KNANAL 
KNCHRG 
KNCMPR 
KNCOMU 
KNMKVL 
KNOMAC 
KNOPTM 
KNOPTY 
KNSECO 
KNTRMV 
| KNTRTY 
I KOADDC 
| KOBXCH 

I 

IKOCVTX 


Checks region boundaries between specified subscripts 

Analyzes type of triple 

Checks for end region for commoning 

Compares code in two matching areas 

Multiplies decimal and binary values 

Lists variables in scratch storage 

Clears the match chain 

Scans subscript lists of DO-loop for matching COMA'S 
Analyzes type of triple 

Scans Subs Table entry for optimizable group of COMA's 
Removes offsets, tidies up, and moves code to match area 
Tests triple type 
Adds two binary values 

Checks DO-loop and patches over ITDO and ITD* triples 
Tests for reference to control variable 


KO&ROR 
KOINIT 
KOMAKC 
KOMCHN 
KOMCOM 
KOMLTC 
KOMOVF 
KOMTCH 
| KOPCOM 
| KOPREC 

I 

I KOPTCE 


Aborts 

Initialization for physical phase 
Creates binary constant 

Amends triples to refer to value in patch 

Creates part of patch for transforms and invariants 

Multiplies two binary values together 

Moves item to next place in patch build area 

Processes match chain and makes an entry in patch file 

Overwrites triple in text with PTCH triple 

Obtains effective precision of binary value 

Makes an entry in the patch file 
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[Routine/Subroutine J 
IKOSBSC 


•Table KOI. Phase KO Routine/Subroutine Directory (continued) 

Function 

| Gets next entry from Subs/Region table 
| KOSNBX | Allocates a sindex register 

IKOSSBE | Moves last part of Subs list to patch build area 

IKOSSBS | Moves first part of Subs list to patch build area 

KOSSB1 | Moves a subscript list to patch build area 

l 

IK0SSB2 | Moves a subscript list to patch build area 

i K0SSB3 j Moves a subscript list to patch build area 

I KOSUBC | Subtracts two binary values 

KOTSTO | Tests if dictionary entry is for binary or decimal constant 

I 

KPCHKP | Checks operands of triples in SSUB list 

I KPSOPC | Sets a code byte after examining a triple operand 

| KPSSUB | Processes triples following a SSUB triple in a patch 

KPUPDT I Searches patch file for SSUB lists 

I KPUSEL | Searches USE List for given dictionary reference 
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• Table KT. Phase KT Pseudo-Code Scan 

r T n 

| (Main Processing! I 

I Statement or Operation Type j Routine | Subroutines Used | 

* + + ^ 

jSCINIT Initialization |LA0005 |UT01,UT02 

^ + + ^ 

| SCI Search for triple of |LA0010 |UT01,UT03,UT06, UT07,UT08 j 

j interest j | | 

j. .j. j. ^ 

( SC2 Move current triple then |LA0011 |UT01,UT03,UT06,UT07,UT08 j 

I search j | | 

h + + ^ 

j SC3 Delete current triple then |LA0012 | UT01, UT03, UT06 f UT07, UT08 | 

j search j | | 

| SC4 Skip current triple - text |LA0020 |UT06 | 

| wanted j j j 

V + + ^ 

| SCb Skip current triple - text (LA0021 |UT06 | 

I free | j | 

j. 1 1 H 

JSC6 Move current triple - text |LA0025 JUT03,UT06 | 

| wanted j j j 

Ih + f 

|SC7 Move current triple - text |LA0026 |UT03,UT06 | 

j free | j j 

+ + 4 

| SC10 Symbolic input pointer to (LA0035 |UT01 | 

j absolute j j | 

I- + + H 

jscil Skip pseudo-code - text (LA0040 JUT06 | 

| wanted j j j 

j. + + 

|SC12 Skip pseudo-code - text |LA0041 |UT06 | 

| free j | I 

|MV2 Move user pseudo-code to |LA0050 |UT04 | 

| contiguous OP j | j 

i- + + i 

|MV3 Move user pseudo-code to OP |LA0055 |UT04 | 

h + + j 

IMV3A Move user triples to OP (LA0056 |UT03 | 

K + + 1 

j DV1 Generate dope vector for |LA0070 |UT07,UT10, UT11 | 

j based aggregate j | J 
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Function 


•Table KT1 . Phase KT Routine/Subroutine Directory 
| Routine/Subroutine | 


r~ - — - - 

|DV1 

1 

(Generate dope vector for based aggregate. 



^ 

1 

| MV 2 

(Move user pseudo-code to contiguous output text. 

i 



! 

1 

1 

| MV 3 

1 

|Move user pseudo-code to output. 

1 



1 

1 

1 

| MV3A 

1 

(Move user triples to output. 

I 



1 

1 

1 SCINIT 

|Initiali 2 e input and output text blocks. 

i 



1 

1 

|SC1 

1 

(Searches for triple of interest to user as indicated 

by 

TRT 

1 

table. j 

| SC2 

1 

(Move current triple to output then search for triple 
j user. 

of 

1 

interest to ( 

1 

| SC3 

i 

(Delete current triple then search for triple of interest 
1 

to 

l 

user. | 

| SC4 

(Skip over current triple and mask input WANTED. 

1 




| SC5 

1 

1 Skip over current triple and mark input FREE. 

i 




| SC6 

1 

(Move current triple to output and mark input WANTED. 

i 




JSC7 

1 

|Move current triple to output and mark input FREE. 

i 




(SC& 

i 

(Move input pseudo- code to output and mark input WANTED. 



| SC9 

i 

(Move input pseudo- code to output and mark input FREE 

i 

• 



|SC10 

1 

(Convert symbolic input pointer to absolute. 

i 




|SC11 

1 

1 skip over input pseudo-code and mark input WANTED. 

i 




| SC12 

1 

(Skip over input pseudo-code and mark input FREE. 

1 




| UT01 

I 

|Get a new input text block. 

| 




| UT02 

1 

(Get a new output text block. 

1 




| UT03 

1 

|Move pseudo- code to output. 

1 




| UT04 

I 

|Move triples to output. 

i 




J DT05 

1 

|Move text to output. 




| DT06 

i 

|Test for end of block and chain to next block if necessary. 

1 


| UT07 

i 

(Convert dictionary reference to absolute. 

1 




| UT08 

1 

|Move input pseudo-code to output. 

| 




! DT10 

I 

(Set adjustable bound values in a dope vector, 
j 




| UT11 

l 

(Convert output text references to absolute. 



j 
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•Table KU. Phase KU DO-loop Control and Merge Patches 

r t r t 

| | Main Processing) | 

| Statement or Operation Type j Routine j Subroutines Used | 

v 7 + + 1 

| The phase KU control routine. This J KUMAIN |MV3A(KT) ♦ all routines in modules j 

jis highest level routine in phase j |KU and KV except KVJUMP, KVSSUB, | 

| j j KVSSBP | 

^ _ + + ^ 

| Phase initialization |KUINIT | ZLOADW, ZUGC, SCINIT(KT) | 

j. •)■ + ■; \ 

| Processing initialization performed | KUSETS |none j 

1 before each return to main scan j | j 

t + + ^ 

| Primary phase scan of text j KUSCN1 j SC3 CKT) , SCI (KT) | 

| Secondary scan of DO-loop |KUSCN2 |SC3(KT), KVERRS \ 

) specification elements only j j j 

t + + i 

| ITDO triple test routine. Loops |KUITD0 j KVERRS j 

jthat are optimizable are detected I j I 

|CV and *CV triple processing JKUCVAR |SC5(KT), ZDRFAB, KVERRS \ 

j routine j j j 

f f + ^ 

| Determination of type of step |KUSTEP | ZDRFAB | 

j. +■ + ■) 

|Fill in loop control skeleton for j KUSKL1 j ZDICRF, MV3A(KT), MV3(KT) j 

j variable step with no s index ) I I 

jreqisters | j j 

t + + ^ 

j Fill in loop control skeleton for j KUSKL2 |MV3A(KT), MV3(KT) j 

) variable step with sindex registers! j | 

| Fill in loop control skeleton for |KUSKL3 |MV3A(KT), toV3(KT) | 

j constant step j j | 

1 Phase finish. Release scratch |KUENDS JZURC, RLSCTL, KVERRS | 

) storage KV and patch file. Return j j j 

j to control j | j 

j. 1 1 .) 

j Patch triple processing routine. JKVPTCH | ZTXTAB, MV3A(KT),' KVSSUB, KVERRS j 

| Each patch is located and inserted j |KVITDP, KVSSBP, KVCOMA, KVCOMR, j 

j * | j KVJUMP | 

I- + + ^ 

J Process all COMR triples | KVCOMR j none j 

| Process all COMA triples | KVCOMA ) none | 

I- + + ^ 

j Process JUMP triples. Used only j KVJUMP |MV3(KT) | 

while processing a patch j j I 

j. + 1 ^ 

j Process SSUB triple. Used only |KVSSUB | ZDRFAB, ZTXTRF | 

j while processing a patch j j I 

Y + + ] 

| Process SSB* triples. Used only | KVSSBP | ZTXTAB | 

| while processing a patch j j J 
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•Table KU. Phase KU DO-loop Control and Merge Patches (continued) 


Statement or Operation Type 

‘T T 

JMain Processing! 
j Routine j 

.X X 

Subroutines Used 


SUBS and GUBO triple processing 
routine 

j KVSUBS 

1 

-X 

1 ZDRFAB, 

! 

X 

ZTXTRF, MV3ACKT) 


SUB* triple processinq routine 

T 

| KVSUBP 

-X 

T ' 

| ZTXTAB 

_j. 



ITD* triple processinq. Insert 
epilogue into text for optimizable 
loops 

j KVITDP 

1 

1 

j MV 3 (KT) 

1 

1 

| 

, MV3A(KT) 


Set up phase error message number 
and parameters 

j KVERRS 

1 

-j. 

j ZUERR, 

1 

X 

Z ABORT 


Search register alias table for 
SS’JB register 

j KVALAS 

J 

T 

j None 

1 

_ x 
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Function 


Table KU1. Phase KU Routine/Subroutine Directory 


j Rotitine/Subroutine j 


h 

j KUCVAR 

(Processes CV and *CV triple in optimizable loop 

i 


i 

| KUFNDS 

1 

(Phase finish. Peleases KV, scratch storage and patch 

i 

text 


| KUINIT 

1 

( Initializes phase KU processing 

i 



| KUITDO 

1 

( Detects DO-loops flagged as optimizable 

i 



| KUMAIN 

1 

| Phase KU control routine 

1 



| KUSCN1 

1 

(Primary scan for phase 

i 



| KUSCN2 

1 

(Scan for DO-loop specification elements 

i 



| KUSETS 

1 

(Processing initialization 

1 



| KUSKL1 

1 

( Sets up variable step sindexes available loop control 

code 


| KUSKL2 

1 

( Sets up variable step no sindexes loop control code 
■ 



| KUSKI3 

1 

| Sets up constant step loop control code 

i 



| KUSTFP 

1 

(Determines type of step 



| KVALAS 

1 

| Searches register alias table for SSUB register 

i 



| KVCOMA 

I 

| processes COMA triples 

1 



) KVCOMR 

1 

(Processes COMR triples 

i 



| KVERRS 

1 

( Processes phase KU errors 

1 



| KV1TDP 

1 

J Inserts loop control epilogue 



| KVJUMP 

1 

J Processes pseudo-code within patches 



1 KVPTCH 

(Processes PTCH triples by reference to patch file 

I 



| KVSSBP 

(Processes SSB* triples occuring within patches 
j 



| KVSSUB 

(Processes SSUB triple occuring within patches 
j 



) KVSUBP 

(Processes all SUB* triples 
| 



| KVSUBS 

L — 

1 

(Processes SUBS triples 


- _j 
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• Chart 08. Pseudo-Code Logical Phase Flowchart 





•COMPILER FNP 
— -->• PROCESS 


OE 


♦ *••«••••• 

ASSIGNMENT 

CCNST BUCT 
PSEUDO-CODE FOB 
ASSIGNMENTS 


RELEASE 
UTILITIES, 
IEMKT , AND 
IEF.LV 


•••••E5* ••••»••*• 

•CONVERSIONS OG* 
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♦.2ND FASS .• 

* . . * 

* . . * 

* YES 


••••*GS* **•***•*• 

•CONVERSIONS OM* 
*-•-*-•-*-*-*-*.* 

* GENERATE * 

* IN-LINE CODE ♦ 

* 2ND PASS • 


H5 •. 

. * *. 

NO .* IN-LINE *. 

*. CONVERSIONS .• 

•.3RD PASS .» 

*. • ♦ 

*. . * 

♦ YES 


•••**J5*********» 

•CONVERSIONS OP* 

• GENERATE * 

* IN-LINE CODE • 
» 3RD PASS • 


••••♦K 5* *•«•*•♦•• 

•CONSTANTS OS» 

•CONVERT CON8TS * 

* TO REOUIRED • 

♦ INTERNALFORM • 
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Chart LB. Phase LB Overall Logic Diagram 


SCAN 



INITIAL PROCESSING 

****G 1 *** ****** 

• ENTRY • 

* TO MAIN ♦- 


***»G3* ******** 

» RETURN * 


IS 

ITEM AN 
ARRAY 


*• 

***K2* ****** 

► ** 



OUTPUT 

♦ 

♦***K3* ♦**♦*•** 


SN2 AND 

♦ 

♦ * 


ASSIGNMENT 



♦ * 

TRIPLES 

* 

a 

>*# 

* * 
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Chart LD 


Phase LD Overall Logic Diagram 
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Chart LG. Phase LG Overall Logic Diagram 
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***************** 


LG0015 
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**** 
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Chart LS. Phase LS Overall Logic Diagram 
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Chart MD. Phase MD Overall Logic Diagram 
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Chart ME. Phase ME Overall Logic Diagram 
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Chart MG. Phase MG Overall Logic Diagram 
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Chart MI 
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Chart MK. 


Phase MK Overall Logic Diagram 
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Chart MP. Phase MP Overall Logic Diagram 
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Chart MS. 


Phase MS Overall Logic Diagram 
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*** * 



• Chart 06. 


Phase 0G Overall Logic Diagram 



•#•• 


♦OUTPUT MODIFIED* 
* * ♦CONVERT AND 8ET* 

► GD ♦< ♦ TO CALL ON OR ♦ 

» * * OP * 

♦•*♦ ♦ ♦ 
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Chart OM 


Phase OM Overall Logic Diagram 


.• IS ITEM *• «8 

• . CONVERT MACNO . • 

*' . * 


->• 


•••••C2********* 

• CNVCDE 
BRANCH ON 
CONTAINED 
•TRANSFER VECTOR 


* YES 
***• 
•OP • 
->• C2 • 


L 




♦♦**E2* **♦♦****• 


♦***F 2^******»^ 
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Chart OP. Phase OP Overall Logic Diagram 


•***C2*»* ****** 


»**«»D3* •**••••** 

* * 

* BRANCH ON * 

>* CONTAINED *- 

♦TRANSFER VECTOR* 


BTTOBN 

BIT TO 
BINARY 


• NO 

**•• I 

* E2 *-> 

•••••• 


*. . * 

* YES 
I ***» 
*OS * 
t->* A2 * 
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Chart OS 


Phase OS Overall Logic Diagram 


* AM • 

* * 


GET SCRATCH 
STORAGE TEXT 
BLOCK. 

SET SCAN * 0 
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YES .** 


LDCOMP V 

***«*B2* ********* 

* GET FIRST ♦ 

* CONSTANT IN • 

* CHAIN. ♦ 

* UPDATE SCAN * 

* BY 1 ♦ 


.* 

*• • * 

* YES 

I **** 
*PA * 
->* B3 * 
* * 

• *** 


GET NEXT 
CONSTANT IN 
CHAIN 


CHAR TJ 
PICTURED CH*R 
CONVERSION 


► J 3 


**«*C1* ********* 

CONVRT ♦ 

.*.*•*.*•*.«•*.* 

INTO LOCATION ♦<- 
GIVEN ♦ 

SEE C3 ♦ 


* 

SCAN 4 .*. 

C2 *. 

. * STATIC * 
YES . ♦ INITIAL 

*. CONSTANT 

*. AND SCAN 
*. ■ 4 .♦ 


****C3********* 

► CONVRT 


CHAR STRING 
TO CHAR 
CCNVERSXON 


t->* J3 < 

* * 


•***D1* ******** 


*>< 

INTO TEXT 



BLOCK 


**< 

SEE C3 

► ** 


* SCAN POOL * 

* FOR SIMILAR ♦ 

* ENTRY * 

* * 
***************** 


FI *. 

* * 
SIMILAR 


D2 *. 
.♦TARGET *. 
.♦DOUBLE WORD*. 
. ALIGNED 
♦.AND SCAN .* 
♦. = 1 .* 

♦ . . • 

♦ NO 


SCAN 2 

E2 *. 
^♦TARGET *. 

YES . *SINGLE WORD*. 

*. ALIGNED AND .* 

* . SCAN . * 

2 .♦ 


*. 


E3 *. 

.* ♦. **** 

. ♦ SOURCE ♦. YES * * 

► . STRING .♦ >♦ K4 ♦ 

* . . * ♦ • 
*. .* ♦♦** 


* NO 


.♦TARGET *. 
UNALIGNED 
AND SCAN 


****G2 ********* 

CONVRT 

INTO TEXT 
BLOCK 
SEE C3 


.* SOURCE *. YES 

*. IN INTERNAL .* 

• . FORM . * 

*. . ♦ 


* CHAR TO 

* BIT STRING 

* CONVERSION 

* 

•***«****»*«•*#* 


'♦♦♦F5********< 

AHITH TO 
ARITH 

CONVERSION 


♦ NO 

I *♦** 

L>* J 3 ♦ 

♦ * 
**** 

* , 

♦ . 


* . 

TARGET « 
CHARACTER 
. STRING . « 


ARITH TO 
HIT STRING 
CONVERSION 


*****|J2* ********* 

* INSERT ENTRY * 

* INTO DICTION- * 

* ARY CONSTANT * 

* POOL FROM ♦ 

* TEXT BLOCK * 


*♦*♦ 

* * 

* A4 ♦ 

• * 
**** 


CHAR STRING 
TO ARITH 
CONVERSION 


ARITH TO 
CONVERSION 


**** 

* • 

♦ J3 *-> 

* * 
**** 


****J3********* 

» * 
* RETURN * 


D 1 

****J4********** 

CHAR TO ♦ 

ARITH ♦ 

CONVERSION ♦ 


K4 


* . 


*♦** 

* * .♦ SOURCE *. NO 

► K4 * >♦. CHARACTER .♦ 

• ♦ ♦. STRING .* 

**** *. .* 


ARITHMETIC 
TC ARITH 
CONVERSION 
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•Table LB. Phase LB Pseudo-Code Initial 


i 

| Statement or Operation Type 

t — — r 

jMain Processing! 
j Routine j 

J. -L 

Subroutines 

Used 

] {scans text for PROCEDURE, BEGIN, 
jand ALLOCATE triples 

1 

| SCAN 

1 

1 

j. . 

ISCINIT, 
j SFSCAN, 

| AUT012 

-j. 

SCI, SC 3, SC5 
ENDRTN, MAIN, 

(all in KT), 
SCAUTO, 

r T 1 ' " ' 

| Scans automatic chain 

j SCAUTO 
j. 

| MAIN 



j Processes INITIAL attribute 
j dictionary items 

j MAIN 

1 

| CNSTWK, 

1 

-j- 

ARRENT 


(Processes IDV statements 

j AUT012 

| ARRENT 

j 



H — - - — - - 

| Processes INITIAL arrays 

| ARRENT 

j CNSTWK 




Table LB1 . Phase LB Routine/Subroutine Directory 
| Routine/Subroutine | 


Function 


v 

I ARRENT <LC) 

I 

| AUT012 

I 

| CNSTWK 

I 

j EUDRTN 

I 

J MAIN 
» 




| SCAN 

I 

j SCAUTO 

l 

| SFSCAN 

L 


Generates triples and pseudo-code for arrays declared with INITIAL. 
Processes IDV (initial dope vector) statements. 

Creates initialization triples. 

Releases phase and scratch storage. 

Processes INITIAL attribute dictionary items. 

Scans text for PROCEDURE, BEGIN, and ALLOCATE triples. 

Scans AUTOMATIC chain. 

Scans through second file statements. 
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Table LD. Phase LD Pseudo-Code Initial 

| j Main Processing! | 

j Statement or Operation Type j Routine j Subroutines Used | 

I- + + ! 

| Scans the STATIC chain for any | STATIC j ENDRTN, ARRENT, CNSTWK, j 

j variable with the INITIAL attribute! JLOVNAS, STRADD | 

l x x j 


Table UDl. Phase LD Routine/Subroutine Directory 

| Routine/Subroutine | Function | 


! ARRENT 

| Processes the initial value string for arrays. 

| 


| CNSTWK 

1 

| Creates constant entries for initial values. 


J CNVERT 

1 

| Converts decimal integer constants used as replication 
| fixed binary. 

1 

factors to j 

| ENDRTN 

1 

| Releases the phase and scratch storage. 

I 


J GAAl 

j Scans array initial value string, 
j 


j GAC3 

j Makes slot for converted constant for arrays. 

1 


1 LOVNAS 

1 

J Calculates the equivalent length in bits or bytes of a 
| variable or adjustable length strings. 

1 

constant for | 

! STATIC 

1 

J Scans the STATIC chain. 


! STRADD 

1 

! Addresses elements of structures. 

I 


J ST0006 

j Locates initial value list. 


j ST0088 

(Resets initial value entry. 


1 ST9999 

1 

| Makes slot for converted constant for scalars. 
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•Table LG. Phase LG Pseudo-Code DO Expansion 


Statement or Operation Type 

f 

Scans text 

For iterative DO triples, pushes 
down stack and examines control 
variable 


Main Processing 
Routine 


Subroutines Used 


I 

I 

-H 

I 

■H 


LG0002 

LG0011 


-H 


SCI (KT) 

PSHDWN, SC5 (KT), CVSCAN 


Pushes down DO stack 




LG0013 


PSHDWN 


For iterative DO* and DO* triples, 
pushes up stack and removes top 
entry 


LG0012 


EXPEVL, POPUP 


-H 

I 

I 

H 


For CV triples, reverts to normal 
scan 


LG0015 


EXPEVL 


LG0017 


+ 

LG0019 


For TO and TO* triples, examines 
argument and assigns to temporary, 
if necessary 

For BY and BY* triples, examines 
expression and determines signs of 
constants; assigns variables to 
temporary 

F 

For WHILE and WHILE* triples, marks 
loop as iterative; generates test 
triples 


— f 


EXPEVL, TESTOP 


^EXPEVL, TESTOP 




^LG0021 


^CODE3 


h 


DO EQUALS triples, assigns 
expression as a temporary; 
generates code to control loop if 
end of specification 




LG0024 


^CODE2, TESTOP 


-+ 


-H 

I 

I 

I 

I 

-H 

I 

I 

— I 


Sets up control variable text in DO 
stack 


CVSCAN 


CVCOPY, PSTYPO, PSTYP1 


Generates loop control code 

^ 

Tests expression result type and 
assigns to temorary if not constant 


C0DE2 


^TESTOP 


CVCODE, DICENT, COMPAR, SWITCHP, 
LMV3AU, LMV3A5, PSTYPO, PSTYP1 

4 i 

DICCHN, LMV3A5 


j. + 

| Moves text from DO stack to output | CVCODE 
i i 


|lMV3AU 
-J. 


■H 

I 
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Table LG1. Phase LG Routine/Subroutine Directory 

| Routine/ Subroutine j Function | 

F f ^ 

| CODE 2 I Generates loop control code. | 

j CODE 3 (Generates loop control code for WHILE. | 

I 1 I 

|COMPAR (Generates triples to test upper limit control expression. | 

t I I 

|CVCODE (Moves text from DO stack to output. j 

I I I 

| CVCOPY (Moves input text to DO stack. j 

I I I 

| CVSCAN (Sets up control variable text in DO block. ( 

I I I 

| DICCHN | Chains dictionary entries. | 

I I I 

| DICENT (Makes a dictionary entry. | 

I I I 

| EXPEVL (LH) (Analyzes expression to determine result type. | 

I I I 

| LG0000 (Initializes phase. | 

I I I 

J LG 0002 | Scans text. ( 

I 1 I 

|LG0010 | When EOP triple encountered, releases scratch storage and passes | 

( (control to next phase. | 

I I I 

JLG0011 (For iterative DO triples pushes down stack and examines control | 

j j variable. | 

I l I 

(LG0012 (For iterative DO* and DO* triples pushes up stack and removes top ( 

j (entry. j 

I 1 I 

(LG0013 | Pushes down DO stack. | 

(LG0015 (For CV triples reverts to normal scan. j 

I I I 

| LG0017 | For TO and TO* triples, examines argument and assigns to temporary | 

( | if necessary. | 

(LG0019 (For FY and BY' triples, examines expression and determines sign of | 

| (constants. Assigns variables to temporary. j 

I I I 

| LG0021 (For WHILE and WHILE* triples, marks loop as iterative and generates J 

j (text triples. | 

I I I 

| LG0022 | When WHILE' triple encountered, branches to generate comparison | 

j j triples. | 

i I I 

| LG0024 | For DO EQUALS triples, assigns expression to a temporary: generates | 

j (code to control loop if at the end of specification. | 

I i I 

(LMV3AU | Moves triples to output. | 

I I I 

| LMV3A5 | Moves one triple to output. | 

I I I 

(POPUP | Removes item from DO stack. | 

j P3HDWN j Pushes down DO stack and initializes new stack entry. j 

IPSTYP0/PSTYP1 j Test pseudo-variable argument type. j 

I I I 

| SWITCHP ( Changes DO stack text markers . | 

(TESTOP (Tests expression result type and assigns to temporary if not | 

| [constant. | 
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•Table LS. Phase IS Pseudo-Code Expression Evaluation 




Stateroent or Operation Type 


Main Processing 
Routine 


Subroutines Used 


-H 


Scans text and branches to 
processing routines; marks phase LW 
and releases control to next phase 


LBO 


ARITH, FUNCT, LZZ1, MOVEPC, 
SCAN (KT), STRING, SUBSPT 


H 


Calculates result type and 
generates pseudo-code for + , -, *, 
/, prefix + , prefix -, compare 
operators, and ADD, MULTIPLY, and 
DIVIDE functions 


ARITH, ARITH 2 


ADDSTK, ASSIGN, CONVT, DICDES, 
EXPONT, GENRPD, GETADX, GETFR, 
GETGR, MOVEPC, REL3TK, SETCPX, 
STRING, SWOP 


h 


■H 


Calculates result type for string 
operators 


STRING 


LZZ1, MOVEPC, STALRG 


Inserts symbolic register in 
subscript triple and stacks result 


SUBSPT 


^ ADDSTK, DICDES 


Inserts workspace description in 
TMPD triples after function, and 
stacks result. Stacks arguments 
tor ADD, MULTIPLY, and DIVIDE 
functions. Adds pseudo- variable 
markers to stack 


FUNCT 




ADDSTK, ARITH, DICDES, GETFR, 
GETGR, SCAN(KT) 


Calculates results types and 
generates pseudo-code for ** 
operator. Generates calling 
sequences to library subroutines 
for complex arithmetic 


EXPONT 


ADDSTK, ARITH2, CONVT, GETADX 
MOVEPC, STALRG, SWOP 


Calculates target type and 
generates assignment triple for 
conversion; sets dictionary entries 
for constants 


CONVT 


ADDSTK, ASSIGN, GETFR, MOVEPC, 
STALRG 


-H 


■H 


-H 


-H 


Interchanges operands; optionally 
loads first operand 


SWOP 


GETADX, GETFR, GETGR 


Obtains free floating or fixed 
arithmetic register; stores it, if 
necessary 


GETFR . GETGR 


GETADX, STALRG 


-H 


Adds items to, and releases items 
from intermediate result stack 


f 

Generates calling sequence for 
complex * and / operators, 
supervises complex arithmetic 

^Inserts TMPD triples after zero 
operands 


ADDSTK, RELSTK 
+ 


None 


-H 


SETCPX 


EXPONT, GETADX 


LZZ1 


RELSTK, SCAN(KT) 


-H 
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Function 


Table LSI. Phase LS Routine/Subroutine Directory 
| Routine/Subroutine | 

ADDSTK (LT) | Adds items to intermediate result stack. 

I 

ARITH/ARITH2 (LT) {Calculate result type and generate code for ♦ , -, * # /, prefix ♦ , 
j prefix -, compare operators, and ADD, MULTIPLY, and DIVIDE 
I functions . 

I 

{Generates an assignment triple and TMPD in the output text. 


ASSIGN 

CONST 

CONVT 

DICDES 

E0P2 

FXPONT (LU) 

FCTDES 

FUNCT 

FXC1 (LT) 

GENRPD 
GETADX (LT) 
GETFR/GETGR (LT) 

LBO 

LBE21 (LT) 

LBFL1 (LT) 

LZZ1 

MOVEPC 

PSI 

RELSTK (LT) 
SETCPX (LU) 

STALRG 

STRING 

SUBSPT 


jsets up dictionary entry for constant operand. 

I 

{Calculates target type and generates assignment triple for 
j conversion . 

I 

{Constructs operand description from dictionary entry. 

I 

| Marks phases wanted/not wanted and releases control. 

I 

Calculates result type and generates pseudo-code for *♦ operator, 
and generates calling sequence to Library subroutines for complex 
arithmetic. 

Inserts workspace description in TMPD triples after function, and 
stacks result. 

Inserts workspace description in TMPD triples after function, and 
stacks result. Stacks arguments for ADD, MULTIPLY, and DIVIDE 
functions. Adds pseudo- variable markers to stack. 

Generates fixed binary pseudo-code. 

Generates pseudo-code for packed decimal operations. 

Sets up address of pseudo-code instruction. 

Obtain free floating or fixed arithmetic register; store it, if 
necessary. 

Scans text and branches to processing routines. 

Tests for operand conversions and constants. 

Generates floating pseudo-code. 

Inserts TMPD triples after zero operands. 

Moves pseudo-code to output text. 

Adds pseudo- variable marker to stack. 

Releases items from intermediate result stack. 

Generates calling sequence for complex * and / operators; supervises 
complex arithmetic. 

Generates pseudo-code to store all arithmetic registers currently in 
use. 

Calculates result types for string operators. 

Inserts symbolic register in subscript triple and puts result in 
stack . 


SWOP 


Interchanges operands and optionally loads first operand. 


Chapter 3; Flowcharts, Tables, and Routine Directories 273 


•Table LV. Phase LV Pseudo-Code String Utilities 


T T" 

Main Processing! 
Routine 


Statement or Operation Type 


Subroutines Used 


H 


| Initializes module; releases 
j control to next module 

| j Converts data item to string; 
j calculates string length 

K 


STRUTO 


None 


~ f 


I 


STRUT1 


j SCAN (KT), STRUT2 

I 




■ 

| Produces a string dope vector 
j description from a standard string 
j description 


STRUT2 


None 


Table LV1. Phase LV Routine/Subroutine Directory 


j Routine/Subroutine j 

h 


Function 


— i 


■H 


LSUT17 

: LSUT22 

I 

ILSUT26 
t LSUT27 
STUTO 
STRUT 1 
STRUT 2 

ZSTUT1 

ZSTUT2 


[Tests whether string length is greater than 256, and if necessary 
generates fixed length calling sequence. 

| Tests whether string dope vector result is required. 

Generates any assignment and TMPD triples. 

Sets up assignment and TMPD triples. 

Initializes module; releases control to next module. 

[Converts data item to string type; calculates string length. 

Produces string dope vector description from standard string 
description. 

[Transfer vector to STRUT1. 

Transfer vector to STRUT 2 . 


j 
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•Table LX. Phase LX Pseudo-Code String Handling 


h 


Statement or Operation Type 


Main Processing 
Routine 


Subroutines Used 


— I 


Initializes phase, scans text and 
branches to processing routines; 
releases control to next phase 


BEGIN 


FUNPT, SCAN (KT), STROP, 
SUBSPT, TMPDT 


^TMPDT 




Processes TMPD triples. Arithmetic 
type TMPDs are ignored. String 
TMPDs are replaced by the top item 
from the string stack 

Processes function and function 
argument triples. Arithmetic type 
functions are ignored. Dictionary 
entries are created for the results 
of string type functions. A 
library calling sequence is 
generated for the BOOL function 
using the mechanism for packed bit 
operations. The result 
descriptions are added to the 
string stack 

Processes subscript triples. 
Arithmetic type subscripts are 
iqnored. A symbolic register or 
workspace offset is added to string 
type subscript triples and the 
string description is added to the 
string stack 


GETMPD, MOVSEL, RELSTK, SCAN (KT) 
SETMPD 


i 

FUNT 


ADDSTK, DICDES , GETADS, GETMPD, 
MOVEPC , RELSTK, SCAN (KT) , SETMPD, 
STROP 


+ 

SUBSPT 


+ H 

ADDSTK, DICDES, SBGNOR, SCAN (KT) 


Y + 

Processes string operations CONCAT, 
AND, OR, NOT and comparisons with 
string type operands. For simple 
cases, in-line pseudo-code is 
generated; otherwise calling 
sequences to the library are 
generated. The results are added 
to the string stack. 


-H 


STROP 


ADDSTK, DICDES, GETADS, GETADX , 
GETMPD, MOVEPC, MOVSEL, RELSTK, 
SCAN (KT) , STRUT (LV) , ASSIGN, 
GETWS4, GETWS8, SBGNER, SBGNR 




Chapter 3i Flowcharts, Tables, and Routine Directories 275 


Table LX1. Phase LX Routine/Subroutine Directory 

| Routine/Subroutine | Function ] 


| ADDSTK 

| Adds strings to the intermediate string result stack. 

i 


-H 

|ADSTR (LY) 

i 

j Constructs dope vector and string descriptions from a 
j descriptor which may describe either a string, or its 

given 

dope vector. 


| ASSIGN 

i 

(Generates an assignment triple and associated TMPDs in the output 

j text . 

1 


| BEGIN 

i 

(Main controlling routine for phase. 

1 



| DICDES 

(Constructs operand description from dictionary entry. 



| FUNPT 

1 

(Processes result returned by functions. 

1 



| FONT 

(Processes funtion and function argument triples. 

1 



| GETADS/GETADX 

1 

(Construct address part of pseudo- code instruction. 



| GETMPD 

(Constructs operand description from TMPD triples, 
j 



|GETWS4 

(Allocates 4 bytes of aligned workspace. 



|GETWS8 

1 

(Allocates 8 bytes of aligned workspace. 



| LB 

1 

| Terminates phase at end of program. 

i 



| LIBl 

(Generates Library calls for string operations. 

1 



| LIL2 (LY) 

(Generates pseudo-code for NOT operation. 



| LIL3 (LY) 

1 

(Generates pseudo-code for concatenation operation. 

1 



| LIL6 (LY) 

1 

(Generates pseudo-code for comparison operation. 



| LIL8 (LY) 

1 

(Generates pseudo-code for AND/OR operation. 

1 



| Lll 

1 m * 
(Generates pseudo-code to convert to string. 



| MOVEPC 

(Moves pseudo-code from buffer to output text. 



| MOVSEL 

J 

(Moves SELL triples to output text. 

1 



| MVC1/MVC2 (LY) 

1 

| Creates MVC instructions. 



| RELSTK 

(Removes strings from the intermediate string result stack. 

1 


| SBGNER 

i 

(Gets next even-odd pair of symbolic registers. 

1 



| SBGNOR 

(Gets next symbolic register. 

1 



| SBGNR 

|Gets next symbolic register. 

1 



| SETMPD 

(Constructs TMPD triples from description. 

1 



| STROP 

(Processes string operations CONCAT, AND, OR, NOT, and 

jwith string type operands. 

1 

comparisons 


| SUBSPT 

(Processes subscript triples. 

1 



| TMPDT 

(Processes TMPD triples. 

1 



|T5 

|Sets flags for triple types. 


j 
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•Table MA. Phase MA Pseudo-code Translate and Verify Functions 

f t r 1 

I (Mam Processing | | 

| Statement or Operation Type j Routine | Subroutines Used | 

J Scans source text | Phase KT (SCAN)jsci (KT) 

| Function marker triple (FNC) |FUNC |sC2(KT), SC3(KT), SC5(KT) ] 

j processor I I I 

| Double coma triple (FNCM) processor | SDCOM |SC2(KT), SC3CKT), SC5(KT) | 

K + + 4 

j Function prime triple (FNC*) JSFNPM |SC5(KT) j 

(processor j j | 

f TRANSLATE function processor |tV10A |tV 31A, TVll ] 

(Creates compile time table |TV11 |TV13A, TV31A \ 

j Converts constant from internal to (TV13A | None j 

(external form and vice versa j j j 

[initializes VERIFY compile time (TV15A j TV13A ~] 

| table | | | 

(VERIFY function floating table JTV17A (MV3(KT) | 

| build II I 

[pseudo-code build for VERIFY (TV18A |MV3(KT) \ 

j function I I I 

(Floating table build for TRANSLATE (TV21A | MV3 (KT) "j 

(TRANSLATE function in line code (TV22A |MV3(KT) | 

[vERIFY function processor |TV24A (TVll, TV31A | 

(Tests for duplicate character IPTTRAN | ERROR j 

j constant I I I 

(Floating table search (TV31A |None j 

y + + ^ 

| Library calling sequence generator ( TV35A |MV3(KT), TEMPW ( 

(updates function dictionary |TV38A |None j 

| reference j j j 

j Obtains workspace jTEMPD j None j 
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•Table MAI. Phase MA Routine/Subroutine Directory 


r T . 

| Routine/Subroutine J 

h 


Function 


ERROR 

FUUC 

PTTRAN 

SDCOM 

SFNPM 

TENIPD 

TEMPW 

TV10A 

TV 11 

TV13A 

TV15A 

TV17A 

TV18A 

TV21A 

TV22A 

TV24A 

TV31A 

TV35A 

TV38A 


Produces error message 

Processes function marker triple (FNC) 

Tests for duplicate character constant 
Processes double coma triple (FNCM) 

Processes function prime triple (FNC*) 

Obtains workspace 
Gets temporary workspace 
Processes TRANSLATE function 
Creates compile time table 

Converts constant from internal to external form and vice versa 

Initializes VERIFY compile time table 

Builds VERIFY function floating table 

Builds pseudo-code for VERIFY function 

Builds floating table for TRANSLATE 

TRANSLATE function in line code 

Processes VERIFY function 

Searches for floating table 

Generates library calling sequence 

Updates function dictionary reference 
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Table MB. Phase M3 Pseudo-code Pseudo- Variables 


Statement or Operation Type 


h 

1 Scans source text 

JPSI operator; starts new entry in 
| stack for pseudo-variable 


Main Processing 
Routine 


Subroutines Used 


■H 


MBOOOi 


SCI (KT) 


M30011 


SWITCH 


Y 

|PSI' operator; completes stack 
j entry and oenerates code for data 
j list items 


^SWITCH, TARGET 


MB0012 


Y 

j Assign completes stack and rescans 
| group of assignments, putting 
j target descriptions out in correct 
j sequence ; generates code for 
j pseudo- variables in stack 

h 


^MB0013 


DRFTMP, MMV3A5, MVTMPD, OUTMPD, 
TARGET 


■H 


Multiple assign; places only target 
descriptors in stack 


MB0014 


MVTMPD 


[constructs pseudo- variable stack 
j entry 

j Places temporary descriptor in 
j output 

Y- 


MB0020 


MVTMPD 


OUTMPD 


MMV3A5 


H 

I 

I 

-H 

I 

I 

—j 


JGets temporary workspace for 
| pseudo- variable, if necessary 
L 


TARGET 


GETWKS 
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Table MB1 . Phase MB Routine/Subroutine Directory 


T 

| Routine/Subroutine | 

I- + 

DRFTMP 
GETWKS 
MB0001 
MB0004 
MB0010 


Function 

Makes temporary descriptor from a dictionary reference. 

Obtains workspace to accommodate a variable of given type. 

Scans source text. 

Multi-switch for triples of interest. 

On reaching end-of-text marker, releases remaining block, and 
releases control of phase. 

PSI operator; starts new entry in stack for pseudo- variable. 

PSI* operator; completes stack entry and generates code for data 
list items. 

ASSIGN; completes stack and rescans group of assignments, putting 
target descriptions out in correct sequence, generates code for 
pseudo-variable in stack. 

Multiple ASSIGN; places any target descriptors in stack. 
Constructs pseudo- variable stack entry. 

Resets input pointer to start of sequence of ASSIGNS. 

Rescans ASSIGNS and associated TMPDS from stack in reverse order. 
Tests for end of stack. 

Tests for pseudo- varaible TMPD. 

Generates code for pseudo- variable. 

Moves one triple to output. 

Places temporary descriptor in stack. 

Places temporary descriptor in output string. 

Changes scanning table. 

Obtains temporary workspace for pseudo-variable, if necessary. 


MB0011 

MB0012 

MB0013 

MB0014 
MB0020 
MB1310 
MB1311 
MB1316 
MB1318 
MB 13 20 
MMV3A5 
MVTMPD 
OUTMPD 
SWITCH 
TARGET 
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• Table MD. Phase MD Pseudo-Code In-Line Functions 
| | Main Processing! 

j Statement or Operation Type j Routine | Subroutines Used 

^ + + 1 

| {Scans text {Phase* KT (SCAN) {None 

^ 


| Builds up function stack |LFARIN 

| Builds up argument stack (LFCOM 

1 J Moves generated code to output jLFMOVE 

j block | 

(Generates in-line code and j LFE0F2 

1 library calling sequences j 


None 




1 

I 

^ 


None 


MV3 (KT) 


| SNAKE, ROPE 


H 




Table MD1. Phase MD Routine/Subroutine Directory 


r — 

j LFA.RI1 

! Continues scan for in-line functions. 



1 

ILFARIN 

j Builds up function stack. 



1 

| LFCOM 

1 

j LFDR 

i 

1 

(Builds up argument stack. 



(Unpacks dictionary reference of argument when 

argument triple 

found. j 

1 

j LFE0F2 

(Calls subroutines to generate in-line code. 



1 

{ LFIGN 

1 

| Removes triple from text if inside an in-line 

function. 


1 

jLFSPEC 

(Branches if IGNORE triple or not an in-line function. 

1 


1 

{rope 

i 

(Generates code for STRING function. 



1 

j SNAKE 

1 

(Generates code for ADDR function. 


J 
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•Table ME. Phase ME Pseudo-Code In-Line Functions 


1 

| Statement or Operation Type 

(Main Processing! 

1 Routine j Subroutines Used 

-j. i ....... 

h 

| Scans and moves text 

i . 

T T 

(Phase KT (SCAN) j SCI , SC2, SC3, SC5, MV3 
j. 

1 

| Builds up function stack 

j SFUNC 

T 

( ZDRAOF 

.j. .- 

j. — — — — _ _ — — — 

(Constructs result TDB and branches 
( to routines for INDEX, UNSPEC, 
(COMPLETION, and STATUS 

l . . 

( SFNPM 

1 

1 

-j- 

j MS 4 , MS5 , MSB, RTAA, RTAB, I NDEX , 
j ILUNSP , EVENT , ZDRAOF , STATUS 

1 

j. 

r ' 

(Deletes current triple 

(Builds up argument stack 

IsiGN 

| SDCOM 

-j. 

( None 

+ 

j ZDRAOF 

| Inspects arguments and branches to 
j appropriate subroutine 

j MSB 
| 

T 

j RTB , RTC , RTD, RTE , RTF , RTG , RTH 

1 

__A__ _ _ _ _ _ 


Table MEl . Phase ME Routine/Subroutine Directory 

| Routine/Subroutine 1 Function | 


(EVENT 

j Generates in-line code for COMPLETION function. 

( 

1 

1 

(FINISH 

1 

(Passes control to the next phase. 

( 

1 

t 

j ILUNSP 

1 

| Generates in-line code for the UNSPEC function. 

1 

1 

1 

i 

( INDEX 

(Generates in-line code for optimizable invocations of the function | 

| INDEX. 1 

i i 

(MSB 

i 

(Calls subroutines to generate in-line code. 

1 

i 

1 

1 

(MSG 

1 

| Resets current flag and continues scan. 

1 

1 

1 

1 

| RLCTOF 

1 

(Releases module and passes to next phase, 
j 

I 

1 

i 

(RTAA 

(Generates in-line code when the result is in a register by name, 
(the second argument is constant. 

1 

and | 

1 

i 

| RTAE 

j 

(Generates in-line code when the result is in a register by name, 
jthe second argument is variable. 

i 

1 

and | 

1 

i 

| RTB 

» » 

(Generates in-line code for the case when the first argument is an | 

j aligned bit string, and the second and third arguments are both | 

| constant . 1 

i 

| RTC 

(Generates in-line code in the case when the first argument is a 
(character or aligned bit string, the second argument is constant 
jthe third variable. 

| 

1 

and j 

|RTD 

(Generates in-line code when the first argument is a character or 
(aligned bit string, the second is constant and the third is not 
j present, 
j 


| RTS 

(Generates in-line code when the first argument is a packed bit 
(string, and the second is constant. 

| 


|RTF 

(Generates in-line code when the first argument is a character 
(string, and the second and third are both variable. 
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Table ME1. Phase ME Routine/ Subroutine Directory (continued) 

| Routine/Subroutine 1 Function | 

I- + ^ 

JRTG (Generates in-line code when the first argument is a character | 

I (string, the second is variable, and the third is not present. j 

I I I 

| RTH (Generates in-line code when the first argument is a bit string, and | 

j (the second is variable. j 

i i i 

| SBERR | Error routine. | 

I I I 

| SBGNER (Gets the next even register and sets the even/odd bit on. | 

I I I 

| SBGNOR (Gets the next odd register and sets he even/odd bit on. | 

jsBGTNR | Gets the next available symbolic unassigned register. j 

| SCAN j Scans for the next triple of interest. | 

I I I 

|SCINIT (Initializes pointers and text blocks. | 

I I I 

| SDCOM | Builds up argument stack. | 

(SFNPM (Generates in-line code. j 

| 3FUNC | Builds up function stack. | 

I I I 

| SIGN (Deletes current triple. ( 

i i i 

(STATUS (Generates code for STATUS function. I 

I I I 

(STRUT2 (Constructs a string dope vector. I 

1 I I 

| SUBl (Generates code to place the address of the first argument plus a | 

j j literal offset into a symbolic register. j 

I I I 

JSUB3 (Generates a ST and DROP instruction, optionally followed by a MVI | 

j | instruction. I 

JSUB4 (Constructs a dictionary entry for the constant JJ, and generates an | 

j j MVC instruction. j 

I I I 

| SUB5 (Generates two STH instructions, followed by a DROP instruction. | 

(SUB6 (Generates an RX instruction to operate on a TDB by a register, | 

| (optionally followed. by an instruction to drop any register used in j 

j (addressing the TDB item. | 

I I I 

| SUB7L (Generates SR, SLDL, OR instructions. ( 

| SUB7R (Generates SR, SRDL, OR and DROP instructions. | 

I I I 

| SUB9 (Calculates correct values for ILEN, IOFF and Y. | 

II I 

| ZDRAOF (Converts a dictionary reference to an absolute address. | 

I I I 

I ZURCOF (Releases scratch core. I 

x x J 
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•Table MG. Phase MG Pseudo-Code In-Line Functions 1 


Statement or Operation Type 
Scans text 


Main Processing 
Routine 


PHASE KT (SCAN) 


Subroutines Used 


None 


Builds up function stack 


LFARIN 


None 


-H 

I 

■H 


Builds up argument stack 

Y 


Move generated code to output 
block . 


LFCOM 

LFMOVE 


None 


MV3 (KT) 


Y- 


H 


Generates in-line code 


LFEOF2 


ABBFLL, ABBFLS , ABSFB, ABSFD, 
ALL0C2, CEILB, CEILD, CEILL, 
CEILS, CMPLXB, CMPLXD, CMPLXL, 
CNASTR, CNVINT, CONJGB, CON JGD , 
CONJGL, CONJGS, ERRFUN, FLOORB, 
FLOORD, FLOORL, FLOORS, IMAGB, 
IMAGFD, IMAGL, IMAGS, REALB, 
REALFD, REALL, REALS, SBGTNR, 
TRUNCB, TRUNCD , TRUNCL, TRUNCS, 
UNSPEC, UTTEMP 


._J 


Table MG1. Phase MG Routine/Subroutine Directory 


| Routine/Subroutine J Function j 

Y + ^ 


ABBFLL 

| Generates 

J argument . 

1 

in-line 

code 

for 

ABBFLS 

1 

| Generates 
| argument . 

i 

in-line 

code 

for 

ABSFB 

1 

| Generates 

1 

in-line 

code 

for 

ABSFD 

1 

| Generates 

in-line 

code 

for 

ALLOC2 

1 

j Generates 

i 

in-line 

code 

for 

CEILB (MH) 

1 

j Generates 
j argument. 

i 

in-line 

code 

for 

CEILD (MH) 

1 

| Generates 
j argument . 

i 

in-line 

code 

for 

CEILL (M3) 

1 

J Generates 
j argument . 

i 

in-line 

code 

for 

CEILS (MH) 

i 

| Generates in-xine coue for 
j floating-point argument. 

1 

CMPLXB 

| Generates 
j argument . 

1 

in-line 

code 

for 

CMPLXD 

1 

| Generates 

in-line 

code 

for 


argument. 


ABS function with long floating-point 

ABS function with short floating-point 

ABS function with fixed binary argument. 
ABS function with fixed decimal argument. 
ALLOCATION function, 
the CEIL function with fixed binary 

the CEIL function with fixed decimal 

CEil function with long floating-point 

the CEIL function wi ; th short 

COMPLEX function with fixed binary 

COMPLEX function with fixed decimal 

COMPLEX function with long floating-point 


CMPLXL 

CNASTR 

CNVINT 


Generates in-line code for 
argument . 

Constructs assignment triple and associated TMPDS. 
Converts a decimal integer constant to fixed binary. 
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Table MG1. Phase MG Routine/Subroutine Directory (cont'd) 


r -i 

| Routine/Subrout me | Function | 


CONJGB 
CONJGD 

CONJGL 

CONJGS 

ERRFDN 
| FLOORS (MS) 

| FLOORD (MS) 

IfLOORL (MS) 

FLOORS (MS) 

I 

1 1MAGB 
IMAGFD 

IIMAGL 

| IMAGS 

! LFARIN 
I LFAR11 
| LFCOM 
j LFDR 
| LFEOF2 
| LFEOF3 

I LFIGN 
LFMOVE 
i LFSPEC 
I REALB 


[Generates code for the CONJG function with fixed binary arguments. 

Generates in-line code for the CONJG function with fixed decimal 
| arguments. 

[Generates in-line code for the CONJG function with long 
floating-point arguments. 

[Generates in-line code for the CONJG function with short 
floating-point arguments. 

| Aborts if Phase IM discovers an error in a function. 

[Generates in-line code for the FLOOR function with fixed binary 
argument . 

Generates in-line code for the FLOOR function with fixed decimal 
argument . 

[Generates in-line code for the FLOOR function with long 
floating-point argument. 

Generates in-line code for the FLOOR function with short 
floating-point argument. 

[Generates in-line code for IMAG function with fixed binary argument. 

Generates in-line code for IMAG function with fixed decimal 
argument . 

[Generates in-line code for IMAG function with long floating-point 
argument. 

Generates in-line code for IMAG function with short floating-point 
[argument. 

Builds up function stack. 

Continues scan for in-line functions. 

I 

[Builds up argument stack. 

I 

[Unpacks dictionary reference of argument when argument triple found. 
[Calls subroutines to generate in-line code. 

[Depending on start of argument list, branches to produce in-line 
code . 

Removes triple from text if inside an in-line function. 

[Moves generated code to output block. 

: 

[Branches if IGNORE triple or not an in-line function. 

[Generates in-line code for REAL function with fixed binary argument. 
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Table MG1 . Phase MG Routine/Subroutine Directory (cont'd) 



REALFD 


REALL 


REALS 


SBGTNR 


TRUNCB 

(MB) 

TRUtICD 

(MH) 

TRUNCL 

(MB) 

TRUHCS 

(MH) 

1 

UNSPEC 

i 

(MH) 

1 

| UTTEMP 



Generate in-line code for REAL function with fixed decimal argument. 


Generate in-line code for REAL function with long floating-point 
argument . 

[Generates in-line code for REAL function with short floating-point 
argument. 

Get next available symbolic register. 

Generates in-line code for the function TRUNC with fixed binary 
| argument. 

(Generates in-line code for the TRUNC function with fixed decimal 
argument . 

[Generates in-line code for the TRUNC function with long 
floating-point arguments. 

Generates in-line code for the TRUNC function with short 
floating-point argument. 

Generates in-line code for the UNSPEC function, 
jcets a required amount of temporary work space. 


j 
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•Table MI. Phase MI Pseudo-Code In-Line Functions 2 


"T T* 

| Main Processing! 
Routine I 


Statement or Operation Type 


h 

| Scans text 

j Guilds up function stack 


Subroutines Used 


■H 

I 

—I 


| PHASE KT (SCAN) j Hone 

■+ + 

ILFARIN | None 


h 

| Builds up argument stack 1 LFCOM 

(Move generated code to output block JLFMOVE 

k + 

(Generates in-line code | LFE0F2 

I I 

[ „ ______ l _ 


None 


+■ 


| MV3 (KT) 


■H 


•H 


| MAXB, MAXD, MAXL, MAXS, MINB, MIND , 
j MINL, MINS, MODB, MODD, MODL, MODS, 
j ROUNDB, ROUNDD, ROUNDL, ROUNDS 


Table Mil. Phase MI Routine /Subroutine Directory 


j Routine/Subroutine j 


Function 


1 LFARIN 


— T 

| LFCOM 



| LFE0F2 


1 

| LFMOVE 



| MAXB/MItIB 

(MJ) 


| MAXD/MIND 

(MJ) 


JMAXL/MINL 

(MJ) 


| MAXS/MINS 

(MJ) 


|MODB (MJ) 



|MODD (MJ) 



JMODL (MJ) 



2 MODS (MJ) 



1 ROUNDB 



1 ROUNDD 



| ROUNDL 



| ROUNDS 

l 


JL 


— i 

I 

-H 


Builds up function stack. 

Builds up argument stack. 

Calls subroutines to generate in-line code. 

Moves generated code to output block. 

Generate code for MAX/MIN function with fixed binary arguments. 

Generate in-line code for MAX/MIN function with fixed decimal 
arguments . 

Generate in-line code for MAX/MIN function with long floating-point 
arguments . 

Generate in-line code for MAX/MIN function with short floating-point 
arguments . 

Generates in-line code for MOD function with fixed binary arguments. 

Generates in-line code for MOD function with fixed decimal 
arguments . 

Generates in-line code for MOD function with long floating-point 
arguments. 

Generates in-line code for MOD function with short floating-point 
arguments . 

Generate in-line code for ROUND function with fixed binary argument. 

Generates in-line code for ROUND function with fixed decimal 
argument . 

Generate in-line code for ROUND function with long floating-point 
arguments. 

Generate in-line code for ROUND function with short floating-point 
arguments. 
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• Table MK. Phase MK Pseudo-Code In-Line Functions 3 


1 

| Statement or Operation Type 

L 

|Main Processing! 
j Routine j 

j. j. 

Subroutines 

Used 

r 

| Scans text 


j PHASE KT 

-j. 

(SCAN) j None 



r 

| Builds up function stack 


j LFARIN 

j. 

| None 
4- 



• 

| Builds up argument stack 


j LFCOM 

T 

| None 



|Move generated code to output 

T 

block ILFMOVE 
x 

jMV3 

X 

(KT) 


| Generates in-line code 

j 


j LFE0F2 

1 

± _ - 

(dim, hbound, lbound, 

| SIGNFD, SIGNL, SIGNS, 

LENGT, SIGNFB, 
FREBIF 


Table MK1 . Phase MK Routine/Subroutine Directory 


— l 

I 

■H 


j Routine/Subroutine j 
-+- 


Function 


j DIM 

j Generates 

1 

code 

for 

DIM function. 



1 

1 

| FREBIF 

1 

| Generates 

code 

for 

FREE function. 



1 

1 

i 

1 HBOUND 

1 

| Generates 

code 

for 

HBOUND function. 



1 

1 

l 

! LBOUND 

1 

| Generates 
| 

code 

for 

LBOUND function. 



1 

1 

1 

| LENGT 

1 

| Generates 

code 

for 

LENGTH function. 



1 

1 

1 

| LFARIN 

1 

j Builds up 

function 

stack . 



1 

1 

1 

1 LFCOM 

1 

| Builds up 

1 

argument 

stack. 



f 

1 

| LFEOF2 

i 

| Calls subroutines to generate in-line 

code. 


1 

1 

1 

| LFMOVE 

1 

| Moves generated code to output block. 

• 



I 

1 

i 

| SIGNFB 

i 

j Generates 

code 

for 

SIGN function with 

fixed 

1 

binary argument. | 

i 

| SIGNFD 

1 

| Gene rates 

code 

for 

SIGN function with 

fixed 

1 

decimal argument. | 

i 

| SIGNL 

1 

| Generates 

code 

for 

SIGN function with 

short 

floating 

point argument. | 

1 

| SIGNS 

1 

| Generates 

code 

for 

SIGN function with 

short 

floating 

1 

point argument. | 
_ j 
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• Table ML. Phase ML Pseudo-Code Calls and Functions 


Statement or Operation Type 


| Main Processing! 
Routine j 


Subroutines Used 


I- + + ! 

1 Scans text j PHASE KT (SCAN) (None 

h + + 1 

| Identifies argument of procedure | FPFNAR |None 

j invocation | j 

| Selects generic built-in function |FPBIF j FPARD1 

|- 

| Selects PL/I generic entry name 




1 


FPGAR 


| FPARD2, FPARD3 , GNSECO 




Table ML1. Phase ML Routine/Subroutine Directory 


| Routine/Subroutinr | Function "j 

j FPA01 j Scans for next argument. j 

I I I 

| FPARD1 | Obtains parameter descriptions relating to built-in function | 

j j arguments. j 

i i I 

JFPARD2 | Obtains successive parameter descriptions relating to the entry j 

j j description of a PL/I generic procedure. | 

I I I 

| FPARD3 | Obtains and stacks full parameter description of a PL/I generic | 

j j procedure. j 

II I 

| FPBIF | Selects generic built-in functions. | 

I I I 

j FPEPCO | Constructs an entry parameter. | 

I I I 

| fpfnar (Identifies arguments of procedure invocations. | 

I I I 

| FPGAR | Selects PL/I generic entry name. | 

| GNFM2 j Replaces generic reference testing for uniqueness. | 

I I I 

| GNSECO | Makes entry in stack of parameter descriptions. | 


•Table MM. Phase MM Pseudo-Code Calls and Functions 


j Statement or Operation Type 

k 

J (Scans text 

| 


(Main Processing! 

( Routine j Subroutines Used 

| PHASE KT (SCAN) | None 

(Scans list, counts arguments and (CFCALL (CFARID, CFFBIR, CFFDVS, CFMVTR, 

(identifies storage class j jcFMVCD 

| Rescans list and generates calling (CFCFSS (CFARHA, CFCALP, CFBIFH, CFMLBR, 

j sequence for library routine | j CFMVCD, CFNEST, UTTMPW, CFA1F1 , 

I j | BASED 
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Table MM1. Phase MM Routine/Subroutine Directory 


| Routine/Subroutine J 

t- 


Function 


+ * 

BASED (MO) J Generates relocation code for based variables. 

I 

BEGIN (Initializes phase. 

I 

CFALF1 (MO) | Places address of invoked routine at the head of its argument list. 

I 

CFARHA (Generates calling sequence. 

I 

CFARID (MO) (Counts arguments and sets STATIC/AUTO flag. 

I 

CFBIFH | Further built-in function identification with relevant parameter 

j setting. 

I 

CFB04 (Restores previous environment. 

I 

CFB021 (Tests nature of function found. 

I 

CFB036 (Restores pointer to start of invocation. 

I 

CFCALL (Scans lists, counts arguments, identifies storage class. 

I 

CFCALP (Completes calling sequence and, if necessary, generates code to 

(initialize dope vector. 

1 

CFC03C (Tests for nested function. 

I 

CFCFSS | Rescans list and generates calling sequence for Library routine. 

I 

CFEXIT (Transfer vector after first scan. 

I 

CFFBIR (Identifies built-in functions, sets parameters for calling sequence 

j generation . 

CFFDVS (MN) (Reserves output text area for generation of code to initialize dope 

j vector when a function returns a string. 

CFL06 (Generates code to set up result dope vector. 

CFL043 (Generates code to place result address in argument list. 

I 

CFMLBR (MN) (Generates code to move a skeleton parameter list which is greater 

jthan 256 bytes. 

I 

CFMVCD (Generates pseudo-code into the output text block. 

I 

CFMVTR (Generates triple into the output text block. 

I 

CFNEST (Handles a nested situation. 

I 

CFY007 | Sets parameters to produce special calling sequences. 

I 

UTTMPW (MN) (Allocates one word of workspace. 
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•Table MP. Phase MP Pseudo-Code BUY Reorder 

r T T T 

| | Main Processing! | 

j Statement or Operation Type j Routine j Subroutines Used | 


| | Main scan routine for phase (MP1 |SCAN(KT), ZDRFAB, ZTXTRF, ZUERR j 


•Table MP1. Phase MP Routine/Subroutine Directory 

| Routine/Subroutine | Function ] 


|uT05 

+ 

|Adds SELL dictionary reference to SELL list if not already there. 

1 

| MP1 

1 

|Main controlling routine for rearranging BUY and SELL statements 
j involved in obtaining VDAs for adjustable length string temporaries. 

i 

| MP3 

i 

| Processes EOP triple. Releases control of phase. 

| 


1 MP4 

1 

(Processes BUYS triple. 

i 

• 

| MP4 A 

1 

(Processes BUYX triple. 

i 


|MP8 

1 

(Continues text scan if not string or arithmetic data, 
j structure . 

| 

or not 

|MP23 

1 

(Continues scan of text. 


j MP26 

1 

(Processes BUYS triple. 

1 


| MP27 

1 

J Processes BUY ASSIGN triple. 


] MP28 

1 

(Processes BUY triple. 

1 


JMP29 

1 

| Processes SUBSCRIPT triple. 

1 


| MP30 

1 

(Processes ASSIGN triple. 


|MP 31 

i 

(Accesses top stack entry. 

i 


|MP86 

1 

(Tests triple for BUYX, and processes. 

i 


|MP87 

1 

(Scans for BUYS, BUY, and SELL triples. 


|MP5 

1 

(Processes SELL triple. 


| SCAN(KT) 

I 

| General scan routine. 


| ZDRFAB 

1 

(Converts dictionary reference to absolute address. 


| ZTXTRF 

1 

| Changes absolute address to a text reference. 

i 


| ZUERR 

I 

| Makes error message entries. 
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• Table MS. Phase MS Pseudo-Code Subscripts 


i 

1 Statement or Operation Type 

(Main Processing! 

| Routine j 

_L X 

Subroutines Used 

| Scans text 

T 

| SBSCAN 

| None 

-j- 


J - ....... . — - — 

|Calculates element offset 

1 

1 1 
i 

j SBSTIH 

1 

I 

j SBASS, 
j SBNEST, 
| UTTEMP, 

i - . _ 

SBCOBI, SBGNOR, SBMVCD, 
SBSUBP , SBSUDV, SBXOP, 
SBOPT, SBFSUB, UTTMPH 

1 -■ ■ ■ 

| Checks subscript range 

j SBSBRN 

| None 
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•Table MSI. Phase MS Routine/Subroutine Directory 


j Routine/Subroutine j 


| SBASS 

I 


i 

j SBCOBI 

l 

(MT) 

1 

| jSBCOMR 

l 

(MT) 

1 

jSBERR 

I 

(MT) 

i 

| j SBFSUB 

1 


1 

j SBGNOR 

(MT) 

1 

j SBMVCD 

i 

(MT) 

1 

| SBNEST 

1 

(MT) 

1 

| j SBOFFS 

i 

(MT) 

1 

| SBOPT 

l 


1 

| SBSBRN 
■ 

(MT) 

1 

| j SB SCAN 

1 


1 

| SBSTIH 

l 


1 

| SBSDBI 

i 


} SBSUBP 

(MT) 

1 

j SBSUDV 

1 


1 

| SBS05 

| 


1 

| SBS06 

i 


1 

j SBS002 


1 

| SBS029 


1 

| j SBS059 
■ 


1 

j SBTRID 


l 

| j SCAN (KT) 

1 

| UTTEMP 

(MT) 

1 

1 lUTTMPH(MT) 

L _ 




Function 

Updates scan pointer over an assignment. 

Converts subscript to binary integer. * 

Handles COMR triple 

Puts error message into dictionary. 

Tests the FIRST flag setting if it is not already set, and exits 
unless FIRST was unset on entry 

Allocates an odd symbolic register. 

Generates pseudo-code and moves it into output text block. 

Handles nested subscript situation. 

Handles OFS triple 

Calculates element offset in optimizable cases. 

Checks subscript range. 

Branches to KT for scan. 

Generates code to calculate element offset. 

Saves array name. 

Handles end of subscript list. 

Generates code to set up the dope vector of an array of adjustable 
strings. 

Generates code to multiply subscript by multiplier. 

Compiles code to convert to fixed binary. 

Checks for occurrence of subscript. 

Generates code to multiply subscript by 4 or 8. 

Generates multiply halfword code modifications 
Scans for comma, subscript prime, or subscript triple. 

Controlling scan of text. 

Allocates workspace. 

Gets two bytes of storage on a halfword boundary 


—1 
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•Table NA. Phase NA Pseudo-Code Branches. ON, Returns 


Statement or Operation Type 


Main Processing 
Routine 


Subroutines Used 


Initializes text block 


NAINIT 


SCINIT (KT) 


Scans text for next triple of 
interest to user 


NASC1, NASC2, 
NASC3 


SCI, SC 2 , SC 3 (all in KT) 


Processes STOP statements 


NAUT1 


Processes EXIT statements 


NAUT1 


Processes IF triples 


NAUTD , NAUT16, NAUT21, ZSTUT1 


Processes ON triples 


NAUTD, NAUT6 , NAUT16, SC5(KT) 


Produces Library call at end of 
each PROCEDURE or BEGIN block in 
source text 


PROCP, BEGINP 


NAUT1 


Processes RETURN triples 


RETURN 


NAUT1 


Processes function RETURN 
statements for one data type 


NA3002 


NAUTB , NAUTCA, NAUT1 , NAUT12 


Processes function RETURN state- 
ments for more than one data type 


NA3013 


NAUTA, NAUTB, NAUTCA, NAUTD, NAUTF , 
NAUT1 , NAUT7, NAUT8, NAUT9 , NAUT11 , 
NAUT12 


Processes GOTO triples 


NAUTD 


Processes GOLN triples 


NAUTj 


Processes GOOB triples 


NAUT5 , NAUTD, NAUT16, SC 5 (KT) 


Processes SIGNAL triples 


SIGNAL 


NAUTD, NAUT6 , NAUT16, NAUT8 , 
NAUT10, NAUT21 


| j Processes REVERT triples 


I REVERT 


| NAUTD, SC5 (KT) 




•Table NA1. Phase NA Routine/Subroutine Directory 

| Routine/Subroutine | Function j 

| EXIT (Processes EXIT statements. | 

I I I 

| GOOB (Processes GCX)B triples. ( 

I I I 

(GOTO (Processes GOTO triples. j 

t I I 

| GOLN (Processes GOTO label number (GOLN) triples. | 

I I I 

(IF (Processes IF triples. | 

| NAINIT (Initializes text blocks. | 

(NASC1/NASC2/NASC3 | Scan text for next triple of interest to user. j 

I I I 

| NAUTA (Generates pseudo-code to test switch value at RETURN (function | 

j (value) statement for more than one data type. | 

I I I 

| NAUTB (Generates assignment triple to RETURN function result. | 

I I I 

| NAUTCA (Generates assignment triple set up by NAUTB. | 

I I I 

| NAUTD (Generates indicated pseudo-code. | 

jiMAUTF (Generates pseudo-code to branch to ECU value. | 
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Table NA1. Phase NA Routine/Subroutine Directory (cont'd) 

Function 


r T* 

| Routine/Subroutine | 




NAUT1 
NAUT2 

NAUT5 

NAUT6 

NAUT7 

NAUT8 

NAUT9 

NAUT11 

NAUT12 

NAUT16 

WAUT17 
N A r JT 1 8 
NAUT21 

NA1100 
HAll 40 
NA3002 
NA3005 
NA3013 
NASO 03 
NA8010 
NA8012 
ON 

PROCP/BEGINP 

RETURN 

REVERT 

SIGNAL 

STOP 

ZSTUT1 


Generates call to indicated library routine. 

Moves indicated pseudo-code, deletes current triple, continues text 
scan. 

Makes dictionary entry for indicated library routine. 

Updates current symbolic register value. 

On entry, register BR points at an entry label dictionary entry. On 
normal exit from the routine, register BR points at the next label 
dictionary entry. Abnormal exit indicates that there are no further 
labels on the current PROCEDURE or ENTRY statement. 

Bump EQU* value for branch pseudo- code item. 

Bump return switch value to be used for current entry label. 

For current entry label, generate appropriate EQU* pseudo-code item. 

Converts current label dictionary reference to an absolute address. 

Converts dictionary reference of triple second operand to absolute 
address, loads address into register BR. 

Makes dictionary entry for maximum negative number. 

Makes indicated dictionary entry. 

Generates pseudo-code to compare source bit string, making library 
comparison routine dictionary entry, if necessary. 

Tests for SNAP. 

Using NAUTD, generates code for ON-units. 

Processes function RETURN statements for one data type. 

Outputs assignment triple. 

Processes function RETURN statements for more than one data type. 
Generates pseudo-code for branch and mask, labels. 

Converts ID to bit- string. 

Outputs pseudo-code. Compares bit-string to zero. 

Processes ON triples. 

Produce Library call at end of each procedure in source text. 
Processes RETURN triples. 

Processes REVERT triples. 

Processes SIGNAL triples. 

Processes STOP triples. 

String utility in Phase LV to provide a dope vector for a specified 
string. 


_j 
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• Table NG. Phase NG Pseudo-Code Operating System Services 


I 


jMain Processing! 


j Statement or Operation Type 

j Routine 

1 

! CALIB, 

1 

Subroutines Used 


r 

I Processes ALLOCATE statements 
(based variables 

i . 

for 

j ALOCAT 

I 

FALUT1 


r 

| Processes DELAY statements 


|DLAY 

.j. 

| CALIB, 

INTEG, SCAN (KT) 


| Processes DISPLAY statements 

1 

j Processes FREE statements for 
(variables 


|dspy 

j 

j CALIB, CHAR, ENDLST, 

| SCAN (KT), STORAD 


based| FREE 

1 

± 

j CALIB, 

1 

FALUT1 


j Processes WAIT statements 


T 

J WAIT 
i _ - 

t - 

j CALIB, 
1 

INTEG, SCAN (KT) ,OPLAST 



Table NG1. Phase NG Routine/Subroutine Directory 

r T 

| Routine/Subroutine | 


Function 


r~ - — — - 
j CALIB 

T 

| 

|CHAR (NH) 

1 

1 

! DLAY 

1 

I 

JDSPY 

1 

1 

) DSPY3 

1 

1 

JDSPY 4 

1 

1 

J DSPY10 

1 

1 

J ENDLST 

1 

| 

1 

! FALUT1 

1 

1 

i 

{INTEG (NH) 

1 

1 

J NGO 

1 

1 

i 

| OPLAST 

1 

1 

■ 

| STORAD 

1 


._ 1 
I 

^ 


Generates part of calling sequence and makes dictionary entry for 
Library routine. 

Converts a given argument to character string. 

Processes DELAY statements. 

Processes DISPLAY statements. 

Tests that operand is character variable. 

Makes dictionary entry for parameter list. 

Scans for REPLY option. 

Completes parameter list and makes dictionary entry for it. 

Examines argument of ALLOCATE or FREE statements to see if variable 
is based and forms RDV in workspace to prepare for call to the 
library. 

Converts a given argument to an integer. 

Scans to next statement. 

Builds up parameter list in workspace. 

Stores an address in a parameter list. 
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•Table NJ. Phase NJ Pseudo-Code RECORD I/O 


h 


Statement or Operation Type 


+ 


Main Processing 
Routine 


Subroutines Used 


Initialize Phase NJ by calling in 
block NK and initializing SCAN 
utility 

Initializes switches and flags to 
indicate start of new statement. 
Determines RECORD-oriented I/O verb 
and goes to appropriate routine 


STRTNJ 


ZLOADW (AA), SCINIT <KT) , SCI (KT) 


+ 

NUSTAT 


TXTEST 


4 


Gets next triple of interest, 
converts to internal code and 
selects the appropriate routine to 
process it 

Processes FILE option of RECORD- 
oriented I/O by placing dictionary 
reference of FILE Declare DCB in 
the appropriate slot of the 
parameter list. The parameter list 
is in STATIC if file constant, 
WORKSPACE if file parameter 


SCNOPT 


SC3 (KT), TXTEST, SCAN01, CMPERR 
TXTERR, Z ABORT (AA) 


-H 


^FILOPT 


-+ -1 

TXTARG, DYNMPL, LAONLY, STDROP, 
CMPERR, TXTERR, WRKSPC, MVPSCD, 
ZTXTRF (KT), SYMREG, MV3 (KT) 


4 


Establishes the record dope vector | INTFRM 
(RDV) for the triple operand and 
places the address in the second 
slot of the parameter list unless 
the operand of the INTO triple is 
A varying string, in which case it 
places the address of the string 
dope vector of the operand in the 
second slot in the parameter list. 


TXTARG, CMPERR, DYNMPL, LAONLY, 
STDROP, LA0SM2, CRDV, TXTERR, 

Z ABORT (AA), WRKSPC, MVPSCD, TXTRF, 
SYMREG, ZDRFAB (AA) , CALLIB, 

ZDICRF (AA), REFRDV, SCALAR, 

PNTRDR, BSDRDV 
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•Table NJ. Phase NJ Pseudo-Code RECORD I/O (cont'd) 


Processes the operand of the 
LOCATE triple by establishing the 
RDV for the triple operand and 
placing this address in the second 
slot of the parameter list. It 
establishes the pointer qualifier 
of the based variable and saves 
this, either to be used, or to be 
overwritten by the operand of a SET 
triple. It establishes a compiler 
label and puts this in the third 
slot of the parameter list in order 
to tell the library where to 
return, so that code assigning the 
pointer value returned in the RDV 
to the saved pointer operand is 
avoided. It then initializes the 
based variables just allocated 

f + 


Statement or Operation Type 


Processes KEYTO option of RECORD- 
oriented I/O by verifying that its 
argument is a character string, 
then placing it in the appropriate 
parameter list slot, which may be 
in STATIC or WORKSPACE 


Main Processing 
Routine 

LOCOPT 


KYTOPT 


TXTARG, SCALAR, DYNMPL, LAONLY, 
STDROP, NXTMPD, ZSTUT2 ( STRUT2 in 
LV), LAOSM2, LAOS Ml , TXTERR , 
ZDRFAB (AA), SC 5 (KT), WRKSPC, 
MVPSCD, MV3 (KT), SYMREG 


Subroutines Used 


TXTARG, ZDICRF, PNTRDR, SCALAR, 
LOCRDV, CMP ERR 


1 


•H 


■H 


KEYOPT 


TXTARG, SCALAR, DYNMPL, LAONLY, 
STDROP, NXTMPD, ZSTUT1 (STRUT1 in 
LV), LAOSM1, LA0SM2 , TMPSEL, TXTERR 




IGNOPT 


Processes the KEY or KEYFROM option 
of RECORD-oriented I/O by 
converting the argument to a 
character string if it is not 
already a character string and 
placing the result in the 
appropriate parameter list slot; 
this is either in STATIC or 
WORKSPACE 

Processes the IGNORE option of 
RECORD-oriented I/O by first 
checking that the argument is a 
scalar and then converting to a 
binary fixed integer if it is not 
already a binary fixed integer. 

The address of the argument is 
placed in the appropriate parameter 
list Slot in STATIC or WORKSPACE 

Processes the event option of 
RECORD-oriented I/O by checking 
that the argument is a scalar EVENT 
variable and placing its address in 
the appropriate parameter list 
slot. The parameter list is either 
in STATIC or WORKSPACE, depending 
upon the storage class of the 
argument. 


EVTOPT 


TXTARG, SCALAR, CINTEG, DYNMPL, 
LAONLY, STDROP, MVPSCD, WRKSPC, 
MVTRPL, LAOSM1, ZDRFAB (AA) , 

CMP ERR, TMPREF, NXTMPD, MV3A (KT) , 
WRKSPC, SYMREG, MV3 (KT) 


+ 1 

TXTARG, DYNMPL, LAONLY, STDROP, 
NXTMPD, TMPREF, TXTERR, WRKSPC, 
MVPSCD, ZTXTRF (KT) , SYMREF, 

MV3 (KT) 
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Table MJ. Phase NJ Pseudo-Code RECORD I/O (cont’d) 


Statement or Operation Type 


Processes the pointer operand of a 
SET triple. If part of a READ 
statement, the address of the 
pointer variable is placed in the 
second slot of the parameter list. 
If part of a LOCATE statement, the 
pointer operand overwrites the 
pointer taken from the based 
variable in the LOCATE statement, 
to be used in the pointer 
assignment code produced by ENDIO. 

At end of I/O statement, places 
| REQUEST_CODE (i.e. IODEF) in sta- 
tic constant chain, puts STATIC 
| parameter list in STATIC chain. 
Creates external Library calling 
| sequence for RECORD-oriented I/O 
[statement as follows: 

I 

j EPRM 

| LA 1, PARM.LIST 

L 15, RECORD. 10. LIBRARY. ROUT 

BALR 14,15 

EPRM 

If there is a WORKSPACE parameter 
list, it updates the MVC or 
parameter list from STATIC to 
WORKSPACE. It checks whether a 
LOCATE statement is being 
processed, for which it generates 
pseudo- code to assign the pointer 
value from the RDV to the pointer 
variable and to initialize the 
REFER variable of a self-defining 
structure. It generates an 
allocate triple to indicate 
possible initialization of TASK 
and/or EVENT variables, and a 
compiler label triple to mark the 
end of initialization code for the 
library. It generates any SELL 
triples accumulated throughout the 
statement on SELL chain. It 
cancels the RECORD-oriented I/O 
option triple codes from the SCAN 
TRT interest table. It gets the 
next triple of interest and goes to 
NUSTAT to process as a new 
statement. 


Main Processing 
Routine 


SETOPT 


ENDIO 


Subroutines Used 


TXTARG, SCALAR, NXTMPD, DYNMPL, 
TMPREF, STDROP, TXTERR 


ZDICRF (AA), LA ONLY, LAOSM1, 
CALLIB, MVPSCD, ZTXTAB (AA) , SELL, 
SC3 (KT) SYMREG, TMPREF, 

ZDRFAB, MVTRPL, RCBCMN 
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•Table NJ. Phase RJ Pseudo-Code RECORD I/O (cont'd) 




j Statement or Operation Type 

[indicates presence of NOLOCK 
j option. 

| 

| Delete the SELL triple encountered 
j during scan of RECORD-oriented 
j I/O statement but puts dictionary 
j reference in the SELL chain so that 
j SELL triple can be regenerated at 
jend of I/O statement 

| At end of program, releases own 
j modules and turns control over to 
j next requested phase 


Main Processing 
Routine 


NLKOPT 




SELL routine 
at SVSELL or 
TMPSELL entry 
point 


PRGEND 


Subroutines Used 


Rone 


ZDRFAB (AA), MV3A <KT) 


^ 


RLSCTL 


H 
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Table NJ1. Phase NJ Routine/Subroutine Directory 


[ Routine/Subroutine | 

h 


Function 


1 


BSDRDV(NK) 

CALLIB 

CINTEG 
CMPERR 
CRDV (NK) 


DEFER 

DELETE 
DYNMPL (NK) 


ENDIC 

EVTOPT 

FILOPT 

IGNOPT 

INTFRM 

KEYOPT 

LAONLY (NK) 

LOCRDV (NK) 

KYTOPT 
LA0SM1 (NK) 

LAOS M2 (NK) 

MVPSCD (NK) 
MVTRPL (NK) 


NLKOPT 


Entry point to CRDV routine which marks it as processing a based 
variable in an INTO or FROM option. 

Creates pseudo-code to call library routine; indicates call in 
dictionary if not previously noted. 

Checks whether argument is a binary fixed integer. 

Indicates compiler error and ABORT, error code in HOLD register. 

Constructs a record dope vector (RDV) entry in WORKSPACE. If the 
dope vector descriptor bit is on, then the routine generates a 
library call to generate the RDV. If the variable has static 
extents and is not a string, the RDV is constructed from information 
in the RDV dictionary entry. If the variable is a string, then the 
RDV is constructed from its string dope vector. 

Indicates compiler error in the case of a deferred feature not 
detected by earlier phase. 

Establishes DELETE code as REQUES T_C ODE . 

Establishes a parameter list in workspace if one is not already 
established. Calculates workspace offset to particular slot 
requested. Establishes a symbolic working register. Establishes 
skeleton pseudo-code for LA, ST, and DROP of register into workspace 
offset. 

Handles operations at end of I/O statement. 

Processes EVENT option. (Not implemented in second version.) 
Processes .FILE option. 

Processes IGNORE option. 

Processes INTO/FROM option. 

Processes KEY or KEYFROM option. 

Outputs pseudo-code for LA into symbolic work register of a 
dictionary reference without any offset modifiers. 

Entry point to CRDV routine which marks it as processing a based 
variable of a LOCATE statement. 

Processes KEYTO option. 

Establishes pseudo-code for a LA instruction into a symbolic work 
register with the address of WORKSPACE and a literal offset which is 
pointed to the argument register. 

Generates LA pseudo-code in which both base and offset are in 
registers. 

Puts pseudo— code assembled in pseudo-code area into output text 
block. 

Invokes SCAN utility to move generated triples into output text 
block. 

Indicates presence of NOLOCK option. 
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Table NJ1 . Phase NJ Routine/Subroutine Directory (cont'd) 


j Routine/Subroutine j 


| NUSTAT 

1 

1 

| NXTMPD 

1 

| PNTRDR 

1 

| PRGEND 

1 

j 

i 

| RCBCMN 

1 

| 

1 

| READ 

1 

| REFRDV 

1 

(NK) | 

|RE WRIT 

1 

1 

| SCALAR 

1 

| SCAN01 

1 

1 

1 

| SCNOPT 

1 

1 

1 

| SCRHOP 

1 

1 

1 

1 1 

| SELL (NK) j 

1 1 

1 

j STDROP 

1 

1 

(NK) | 

1 

1 

jSTRTNJ 


1 

j SYMREG 
■ 

(NK) | 

j TMPREF 

i 

(NK) | 

i 

| TMPSEL 

1 

(NK) | 

1 

| TXTARG 

1 

1 


1 

1 

j TXTERR 
| 


j TXTEST 

1 


1 

j UNLOCK 

1 


1 

j WRITE 

1 


1 

jWRKSPC 

■ 

(NK) | 

1 




Function j 


Handles operations at start of new statement. 

Invokes SCAN utility to get next triple, which is checked to see if 
it is a TMPD; if not, it is an error. 

Establishes the seven-byte pointer information slot in a BASED 
variable dictionary entry. 

Releases control to next phase at end of program. 

Commons the dictionary entries of request code blocks. 

Establishes READ code as REQUEST_CODE ; establishes parameter list 
size. 

Establishes the address of the RDV dictionary entry in the ARG 
register when given the data variable dictionary address in INDX1. 

Establishes REWRITE code as REQUEST_CODE . 

Confirms that dictionary code byte refers to scalar item? ascertains 
whether item is a constant. 

Indicates compiler error in the case of a deferred feature not 
detected during Read-In. 

Gets next triple of interest, branches to appropriate routine. 

Searches options, inserts RECORD- oriented I/O option entries into 
SCAN TRT interest table. 

Generates SELL triples for all dictionary references in the SELL 
chain. 

Outputs pseudo-code to ST contents of symbolic work register into 
parameter list slot in workspace set up by DYNMPL, and the drop of 
the symbolic register. 

Initializes phase. 

Establishes symbolic work register. 

Generates the appropriate LA pseudo- code to load the address of the 
temporary described by TMPD. 

Adds temporary entry to SELL chain for generation of SELL triple 
upon completion. 

Processes second argument of triple. If dictionary reference, 
establishes absolute address in INDX1. Returns to LR if zero, i.e. , 
TEMP, LR+4 if dictionary reference. If null, indicates compiler 
error. 

Writes error message. 

Converts function code of triple interest TRT table to internal key, 
and invokes PRGEND if end of program is indicated. 

Establishes UNLOCK code as REQUEST_CODE . (Not implemented in second 

version. ) 

Establishes WRITE code as REQUEST_CODE . 

Establishes the requested workspace area, starting on fullword 
boundary . 


—j 
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• Table NM. Phase NM Pseudo-Code Executable I/O 


(Main Processing) 

Statement or Operation Type j Routine j Subroutines Used 


I Processes GET and PUT statements 


j GET 


^ 

| INSERT, S TOR AD, INSTFL, GENPC, 
(GENTR, MVTRSP, ENDLST, CALIB, 

| CHAR, INTEG, UTTMPW, SRCERR , 
j SCAN <RT), STRUT1 (LV) , STRUT 2 (LV) 

| INSERT, S TOR AD, INSTFL, GENPC ^ 

j GENTR , MVTRSP, ENDLST, CALIB, 
j CHAR, INTEG, UTTMPW, SRCERR, 
j SCAN (KT), STRUT1 (LV) , STRUT2 (LV) 


k + + 

(Processes OPEN and CLOSE statements | OPEN 


Table NM1. Phase NM Routine/Subroutine Directory 
| Routine/Subroutine | 


Function 


4 


CALIB (NN) 

(Generates part of calling sequence and makes dictionary 
j Library routine. 

i 

entry 

for 

CHAR (NN) 

i 

| Converts a given argument to character string. 

i 




ENDLST (NN) 

1 

| Completes parameter list and makes dictionary entry 
j 

for 

it. 


GENPC (NN) 

l Moves pseudo-code to output. 

1 




GENTR (NN) 

j Moves generated triples to output. 




GET 

1 

(Processes GET and PUT statements. 




GET00 

1 

Unitializes switches for GET/PUT. 

| 




GET20 

1 

(PAGE option. 




GET85 

1 

(Processes end of I/O statement. 

I 




INSERT (NN) 

1 

| Inserts dictionary reference in parameter list. 

1 




INSTFL (NN) 

1 

| Inserts file reference in parameter list. 

i 




INTEG (NN) 

i 

(Converts a given argument to integer. 

1 




MVTRSP (NN) 

1 

(Moves data and format list triples to output. 

1 




NMRl 

1 

| Begins scan for triples of interest. 




OPEN 

1 

(Processes OPEN and CLOSE statements. 




OPENOO 

1 

| Initializes switches for OPEN/CLOSE. 

1 




SRCERR (NN) 

j Makes error dictionary entry. 




STORAD (NN) 

(Generates pseudo-code to store symbolic register in 

1 

parameter 

list. 

UTTMPW (NN) 

1 

| Obtains temporary workspace. 
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•Table NT. Phase NT Pseudo-Code Data and Format 




NT0000 


None 


Initializes phase, obtains scratch 
storage 

NT0003 


h 


Collects remote format items and 
saves until end of block 


Statement or Operation Type 


T 

Main Processing 
Routine 


Scans text 


NT0011, NT0014, NT0017, NT0021, 
NT0023, NT0024, SC2 (KT) 

None 


Identifies type of data list item 
and enters the type code in a list 


Associates format and data list 
items and marks INCLUDE matrix 


None 


Identifies type of format list item 
and enters the type code in a list 

Sets bits in INCLUDE matrix to 
represent STREAM I/O conversion 
requirements at execution time 


Makes dictionary entry for Library 
Routine 


NT0011 


NT0014 

NT0017 


NTUT10 


NTUT20 


Associates remote format items with| 
data list items 

Makes entries for Library routines 
required for EDIT-directed I/O and 
copies skeletons for phase NU into 
scratch storage, then releases 
phase 


NT0021 


NT0023 

NT0024 


NTUT10 


Subroutines Used 


None 


NTUT10 


None 


None 


■H 

■H 

-H 

-H 

-H 

-H 
-H 
— I 
-H 


NTUT20 


J 


| Routine/Subroutine | 
^NTOOOO 




Table NT1. Phase NT Routine/Subroutine Directory 

Function 

Initializes phase, obtains scratch storage. 

I 

NT0001 (Initializes phase address slots. 

I 

NT0003 | Scans text. 

I 

NT0011 (Collects remote format items. 

I 

NT0014 (Associates remote format items with data list items. 

NT0017 (Makes entries for Library routines for EDIT-directed I/O. 

I 

NT0021 (Identifies types of data list items. 

I 

NT0023 (Associates format and data list items. 

NT0024 (Identifies types of format list items. 

NT1700 | No EDIT-directed I/O, therefore no scan pass. 

I 

NTUT10 (Sets bits in INCLUDE matrix. 

I 

NTUT20 | Makes dictionary entry for Library routine 
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•Table NO. Phase NU Pseudo-Code Data and Format Lists 


Statement or Operation Type 


H 

| Generate Library calling sequences 
| for data items in DATA-directed I/O 
j statements 

y 

{Generate Library calling sequences 
| for data items in LIST-directed I/O 
j statements 

| Generate code for data items in 
j EDIT- directed I/O statements 

I* 

| Scan text 

y 


Main Processing 
Routine 

NU0022 


Subroutines Used 

^INSERT, UT24,UT11,UT23 ^ 


1 


NU0023 


INSERT, UT11, UT25, UT14,UT23, UT09 


NU0024 ^ 


UT09, 14 ** 


H 

I 

-H 

I 

I 

I 

j 


NU0002 


j Generate Library calling sequences 
for format list items 


NU0029,NU0030 
NU0033, NU0037 , 
NU0050 


SCKKT), SC2 (KT) , SC3(KT) 
UT1 5 , UT1 8 f BCDCNV, UT10 


L I L 


Table NU1. Phase NU Routine/Subroutine Directory 


j Routine/Subroutine j Function j 

j convert decimal constant to binary. j 

Add an entry to an argument list. 

Scan text. 

Generate Library calling sequence for DATA-directed data list item. 

Generate Library calling sequence for LIST-directed data list item. 

Generate cards for EDIT-directed data list item. 

Generate Library call for A or B format item. 

Generate Library call for E or F format item. 

Generate code for R format item. 

Generate Library call for P format item. 

Generate Library call for X, PAGE, SKIP, LINE, C, or COLUMN format 
item. 

Make dictionary entry for constant in EDIT or LIST list. 

Convert a constant entry to one of specified type. 

Generate Library calling sequence passing argument list. 

Generate code for intermediate result items in EDIT and LIST data 
lists. 

Make dictionary entry for FED or DED. 

Generate an assignment triple. 

Generate Library call code. 

Construct symbol table dictionary entry. 

Set bit in the INCLUDE matrix. ^ 


j BCDCNV 

(NV) 

| INSERT 


|NU0002 

(NV) 

|NU0022 


| NU0023 


| NU0024 

(NV) 

| NU0029 

(NV) 

| NU0030 

(NV) 

1 NU0033 

(NV) 

| NU0037 

(NV) 

| NU0050 

(NV) 

| UT09 


| UT10 


| UT11 


| UT14 


| UT15 

1 


1 

| UT18 (NV) 

■ 

1 

j UT23 

i 


1 

j UT24 
■ 


1 

IUT25 
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•Table OB. Phase OB Pseudo-Code Compiler Functions 


Statement or Operation Type 


Scans text for BUY, BUY ASSIGN I 
statements and compiler function 
and compiler pseudo-variables (see 
Appendix D.8), and transfers to 
appropriate routine 
— 

Replaces MTF compiler functions 
(Appendix D.8) by pseudo-code move 
character instructions, adjusting 
the target field to controlled or 
temporary type 2 workspace where 
necessary 

Replaces ADV compiler functions 
(Appendix D.8) by pseudo-code 
instructions to load specified 
element of a dope vector into a 
register 

Replaces SDV compiler functions 
(Appendix D.8) by instructions to 
load the maximum length from a 
string dope vector into a register 
— 
Replaces compiler pseudo- variable 
triples and compiler assignment 
triples by pseudo-code instructions 
which store the value assigned in 
specified part of dope vector 

Remove BUY, BUY ASSIGN, and SELL 
statements for scalar 
non-adjustable temporary variables 
from the text, and allocate storage 
in the pseudo-code workspace for 
the temporaries 

Generates code to drop a symbolic 
register, or mark a literal 
register not wanted 


Main Processing 
Routine 


f 

ADVR I SC3 (KT) 


ST8, ST10, ST7 


DROPRG 


Subroutines Used 


SCAN (KT) 


BUFIZE, FRSTOP, SC3 (KT) 




SDVR |sC3 (KT) ~1 


BUFIZE, STACK, MV3A (KT) , 
DROPRG, USTACK, SC5 (KT) 


SC2, SC3 (both in KT) 


FRSTOP, 1 


4 
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• Table OB. Phase OB Pseudo-Code Compiler Functions (continued) 


T T 

Main Processing 
Routine 


Statement or Operation Type 


Subroutines Used 


Determines whether the target 
dictionary reference of MTF 
function, or ADV or SDV 
pseudo- variable is controlled or a 
temporary type 2. If it is, the 
dictionary reference is replaced by 
the dictionary reference of the 
controlled or temporary type 2 
workspace, with the appropriate 
offset, if the target is a 
structure base element 
Stack and unstack the information 
specifying the target field of 
compiler pseudo- variable assignment 


FRSTOP 


SETDVF 


STACK, USTACK 


None 


•H 


Calculates the offset of the dope 
vector of a structure base element 
from the start of the structure 
dope vector 


SETDVF 


None 


*SC5 (KT) 


■H 


Place triples from the source text 
in an internal buffer. 


BUFIZE 
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Table OBI. Phase OB Routine/Subroutine Directory 

r t 

| Routine/Subrout ine | 

h +— 

IADVR 


Function 


| AT7 

I 

I AT8 
BUFI ZE 

I 

|BY5 

[BY19 

DFOPRG 

| FRSTOP 

! 

|MTFR 

I 

ISDVR 

SETDVF 


| STACK/USTACK 


IST1 


| ST4, ST6 


ST7,ST8,ST10 


Replaces ADV compiler functions by pseudo-code instructions to load 
| the specified element of a dope vector into a register. 

I 

| Generates pseudo- code. 

I 

| Replaces operand by workspace reference. 

[Places triples from the source text in an internal buffer. 

[Tests length of string. 

Processes string temporary (dope vector only) . 

j Generates code to drop a symbolic register or mark a literal 
register not wanted. 

[Replaces the target field of MTF function or compiler 
[pseudo-variable by controlled workspace where necessary. 

| Replaces MTF compiler functions by pseudo-code move character 
instructions . 

Replaces SDV compiler functions by pseudo-code instructions to load 
the maximum string length into an object register. 

I 

[Calculates the offset from the start of a structure dope vector to 
the dope vector of a particular base element. 

[Stack and unstack information specifying target field of compiler 
j pseudo-variable assignment. 

Scans text for BUY and BUY ASSIGN statements, compiler functions, 
and compiler pseudo- variables. 

[Replaces compiler pseudo-variables and compiler assignment triples 
by pseudo code instructions to set the assigned expression, 
converted if necessary in the specified part of a dope vector. 

[Remove BUY, BUY ASSIGN, and SELL statements for fixed scalars from 
| the text, and allocate space for the temporary variables in the 
[pseudo-code workspace. 
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Table OD. Phase OD Pseudo-Code Assiqnment 

r t T' 

| | Main Processing) 

j Statement or Operation Type j Routine j 


h 


f 


(Get block of scratch core |SCRCOR 

K + 

{Move routines, constants and tables | MOVTAB 
| to block | 

L X 


4 

| None 

4 


1 None 

I 


Subroutines Used | 

-| 

I 



I 

I 

j 


Table OD1. Phase OD Routine/Subroutine Directory 
| Routine/Subroutine | Function 

j. + 

| SCRCOR | Obtains block of scratch core. 

I I 

| MOVTAB | Moves routines, tables and constants into scratch core. 

L X . 


I 


-J 
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Table OE. Phase OF. Pseudo-Code Assignment 

r t f 

| | Main Processing! 

| Statement or Operation Type j Routine j 

{Generates pseudo-code for jASSOO JASCOO, ASCDOO, ASDROP 

jassianroent triples j j 

h 


Subroutines Used 


H 


| Generates Library calling sequences j ALLOC, FREE, JCALIB 
j for ALLOCATE, FREE, BUY, and SELL |BUY, or SELL j 

j triples I | 

L A L 


Table OE1. Phase OE Routine/Subroutine Directory 


| Routine/Subroutine 

Function 

r 1 

j ALLOC (OF) 

Processes ALLOCATE triples. 

| ASCOO 

Inserts target types for constants. 

| ASCDOO 

Controls assignment of real and complex data. 

| ASDROP 

Drops symbolic registers. 

| A3FB00 

Generates code for fixed binary assignments. 

I ASFDOO (OF) 

Generates code for fixed decimal assignments. 

| ASFLOO 

Generates code for floating-point assignments. 

| ASLOO 

Generates code for label assignments. 

1 

| ASI-'OOO 

Generates code for pointer/offset assignment. 

| ASAROO 

Generates library calling sequence for area assignment. 

| ASSOO 

Processes assignment triples. 

| ASS032 

Tests for special assignment triple. 

| ASTROO (OF) 

Generates code for string and numeric field’ assignments 

| BUY (OF) 

Processes BUY triples. 

| CAL1B (OF) 

Generates Library calling sequences. 

| ENABLE 

Enables for SIZE prefix option. 

| FREE (OF) 

Processes FREE triples. 

| GENCNV 

Generates convert macro instruction. 

| GEIJRXO 

Generates RX instruction. 

| GENSSO 

Generates SS instruction. 

| GETDES 

Obtains operand description. 

J AMNDX 

Removes index from operand. 

| SBGTNR 

Obtains next symbolic register. 

| SELL (OF) 

Processes SELL triples. 

|SPASS (OF) 

Processes special assignment triples. 


I 

H 
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•Table OG. Phase OG Library Calling Sequences 


Statement or Operation Type 


Main Processing 
Routine 


Subroutines Used 


Scans triples and takes action on 
their values 


TRSCAN 


EOBIN , TSCSNO , TSCCLB , TSCPRC , FMT001 , 
TSCEOP, TSCEP2 , JSC JMP , MOVITM , MOVOUT 


Scans pseudo-code deleting IGNORE 
items and detecting CONVERT items 


PCSCAN 


CNVFND, MOVITM, MOVOUT 


Examines fields of CONVERT, and 
determines whether the conversion 
is to be done in-line 


IEMOH 


MJG 201,1 EMOI , CODCAL 


Generates Library calling sequence 


MJG201 

IEMOI 


MJG203, MJG 20 4, MJG298 


Generates in-line code for selected 
conversions 


BITODI , FDTOFB , FIBFLT , DECFLT , PICHAR 


^IEMOL 


Generates in-line code for pictures 
containing not more than four of 
the insertion characters (/ , . 
blank), if the target field is 
fixed decimal, fixed binary, float 
decimal or float binary 


SILCON, MOVOUT 
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| Routine/Subroutine | 


•Table 0G1. Phase OG Routine/Subroutine Directory 

Function 

Entered when an end of input block marker is detected. 

Processes SN, SN2, and 3L triples. 

Processes CL triples. 

Processes PROC, PROC 1 , BEGIN, and BEGIN 3 - triples, and sets up counts 
for work space requirements. 

Handles the workspace requirements for FORMAT and FORMAT LIST. 
Processes EOP triple. 

Processes EOP2 triples and terminates phase. 

When a JUMP triple is found the routine sets up a counting mechanism 
and enters PCSCAN. 

Moves from input an item which spans blocks. 

Moves an item to the output block. 

When a CONVERT is found passes control to IEMOH and outputs 
pseudo-code generated on return. 

Generates pseudo-code to call the Library conversion package. 

Given a DED generates a code byte used by the in-line conversions. 
Generates pseudo-code to point registers at data. 

Generates pseudo-code to call Library conversion module. 

Sets bits in include card matrix. 

Generates in-line code for binary to decimal conversion. 

Generates in-line code for decimal to binary conversion. 

Generates in-line code for decimal to float conversion. 

Generates in-line code for fixed binary to float conversion. 

Generates in-line code for picture to character string conversion. 

Generates in-line code for pictures containing not more than four of 
the insertion characters (/ , . blank), if the target field is 
fixed decimal, fixed binary, float decimal or float binary 
conversion. 


! EOBIN 


T 

1 

| TSCS NO 


1 

1 

| TSCCLE 


1 

1 

| TSCPRC 


1 

| FMT001 


I 

1 

| TSCEOP 


1 

1 

| TSCEP2 


1 

| 

| TSCJMP 


1 

1 

| MOVITM 


1 

| 

1 

| MOVOUT 


1 

j 

i 

| CNVFND 


1 

1 

| MJG201 

(OH) 

1 

1 

1 

| CODCAL 

(OH) 

1 

| MJG203 

(OH) 

I 

1 

|MJG204 

(OH) 

I 

1 

| MJG298 

(OH) 

1 

1 

JBITODI 

(01) 

I 

1 

1 

| FDTOFB 

(01) 

1 

1 

1 

| DECFLT 

(01) 

1 

1 

1 

j FIBFLT 

(OI) 

1 

1 

I 

| PICHAR 

(01) 

1 

| 

1 

| SILCON 

(OL) 

1 

L _ 


1 

| 
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Table OM. Phase OM In-line Data Conversions 


Statement or Operation Type 

|Main Processing! 

j Routine | Subroutines Used 

X X 


Scans text for 

CNVC macros 

j TEXTSC 

T 

| None 


Passes control 
routines 

to code generation 

| CNVCDE 

1 

x_ 

T 

| PACK , UNPACK , EDIT , EDMK 

1 

— X _ _ _ 



Table 0M1. Phase OM Routine/ Subroutine Directory 

Function 

Passes control to the in-line code generation routines. 


r t* 

| Routine/Subroutine | 



T 

| CNVCDE 


| EDIT 


| EDMK 


| PACK (ON) 


| PTNGEM 


| TEXTSC 


| UNPACK (ON) 



j 


1 


Generates conversion code, based on the ED instruction, for FIXED 
DEC to PICTURE conversion which includes punctuation and/or zero 
suppression. 

Generates conversion code, based on the EDMK instruction, for FIXED 
DEC to PICTURE conversion which includes a drifting sign. 

Generates conversion code, based on the PACK instruction, for 
PICTURE to FIXED DEC conversion when the picture contains only 9's 
and V, and has only external sign or edit characters. 

Generates the editing constant or mask used by the ED or EDMK 
in-line instructions. 

Scans text for CNVC macros. 

Generates conversion code, based on the UNPK instruction, for FIXED 
DEC to PICTURE containing only 9's and V, and with only external 
sign or edit characters. 

j 
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Table OP. Phase OP Further In-line Conversions 


Subroutines Used 


jMain Processing! 

| Statement or Operation Type j Routine | 

| Initialize and perforin test scan to|TEXTSC ICNVCDE 

j search for convert macros j j 

j. 1 1 

| Examine convert macro and select JCNVCDE | BNTOBT, BTTOBN, FLTOBN 

j routine to generate in-line code j j 

L J L , 


■H 


Table OP1. Phase OP Routine/Subroutine Directory 


| Routine/Subroutine 
| BNTOBT 

I 

j BTTOBN 

I 

| FLTOBN 

I 


| Function | 


(Generate in-line code for conversion from fixed binary to bit string j 

I I 

| Generate in-line code for conversion from bit string to fixed binary! 

I I 

(Generate in-line code for conversion from float binary to fixed | 

j binary | 
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Table OS. Phase OS Constant Conversions 


Statement or Operation Type 


Main Processing 
Routine 


Scans constants 
word constants 

chain 

for 

double 

j SCANl 

1 

-.j- 

j POOLSC, 

1 

-j- 

SCN010, 

STPTST 

! 

1 

Scans constants 
word constants 

chain 

for 

single 

| SCAN2 

1 

.X 

j POOLSC, 

1 

.j. 

SCN010, 

STPTST 

| 

1 

1 

J 

Scans constants 
constants 

chain 

for 

T 

unaligned J SCAN3 

i 

j. 

| CONVRT, 

1 

..j. 

IADENT, 

SCN010 , STPTST 

1 

1 

1 

Scans through constants chain for 

j SCAN 4 

1 CONVRT, 

STPTST 


1 


Subroutines Used 


all constants used to initialize 
STATIC storage 


Sets up parameter and branches to 
the correct conversion routine 


CONVRT 


4 

ARARD, ARBTD, ARCHD, CHARD, ERROUT, 
IACONV, IASTRN, IHEVFA, IHEVFB , 
IHEVFC, IHEVFD, IHEVFE , IHEVKF , 
IHEVKG, IHEVPA, IHEVPB, IHEVPC, 
IHEVPD, IHEVPE, IHEVPF, IHEVPG, 
IHEVPH, UPAA, UPAB, UPBA, UPBB, 

VSAA, VSCA, VSDA, VSEA, ZEROPT 


Table 0S1. Phase OS Routine/Subroutine Directory 

j Routine/Subroutine | Function | 

^ 1 — T 7 — — 7 1 


j ARARD 


j Handles the linking of routines required for any arithmetic to 
j arithmetic conversions (corresponding Library module IHEDMA) . 


| ARBTD 


1 

| As above for arithmetic to bit conversion (corresponding Library 

j routines IHEDNB) . 

1 


| ARCHD 


j Arithmetic to character (IHEDNC). 


| CHARD 


1 

(Character to arithmetic (IHEDCN). 

| 


| CONVRT 


j Sets up parameters and branches to correct conversion routine. 


| ERROUT 


(Handles the output of error messages for the conversion routines. 

1 


| IACONV 


1 

(Handles conversion to arithmetic type. 

1 


| IADENT 


(Makes dictionary entry in the constant pool, generating a new 
(constant pool block if necessary. 

| 


| IASTRN 


j Handles conversion to string type. 

i 


J IHEVFA 

COT) 

(Converts radix long floating-point binary to packed decimal 
( intermediate. 

i 


| IHEVFB 

COT) 

(Converts long precision floating-point number to fixed binary. 


| IHEVFC 

(OT) 

j Converts long floating-point number to floating-point variable, 
j 


| IHEVFD 

(OT) 

(Converts fixed point binary integer with scale factor to long 
(precision floating-point intermediate. 

1 


j IHEVFE 

(OT) 

(Converts floating-point number of specified precision 
j floating-point. 

J 
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Table 0S1. Phase OS Routine/Subroutine Directory (cont'd) 

Function 


| Routine/Subroutine \ 


IHEVKF (OU) 

IHEVKG (OU) 

IHEVPA (OT) 
IHEVPB (OU) 
IHEVPC (OU) 
IHEVPD (OT) 

IHEVPE (OT) 
IHEVPF (OT) 

IHEVPG (OT) 

IHEVPH (OT) 

LDCONP 

POOLSC 

SCAN1 
SCAN 2 
SCAN 3 
SCAN 4 

SCN010 

STPTST 

UPAA (UPAB) (OT) 

UPBA (UPBB) (OT) 
VSAA (OT) 

VSCA (OT) 

VSDA (OT) 

VSEA (OT) 

ZEROPT 


Converts packed decimal intermediate to decimal fixed or 
floating-point numeric field with specified precision. 

Converts packed decimal intermediate to a sterling numeric field, 
with specified precision. 

Converts packed decimal intermediate to long float. 

Converts packed decimal intermediate to an F format item. 

Converts packed decimal intermediate to an E format item. 

Converts packed decimal intermediate to a decimal integer with 
specified precision and scale factor. 

Converts an F or E format item to packed decimal intermediate. 

Converts a decimal integer with specified precision and scale factor 
to packed decimal intermediate. 

Converts binary fixed or floating-point constant to long precision 
floating-point . 

Converts bit string constant with up to 31 significant bits, to 
floating-point with long precision. 

Points to head of constant chain. 

Given a converted constant in scratch storage, scans the existing 
pool for an identical entry. If such an entry is found, the pool 
offset and dictionary reference of the entry is moved into the 
dictionary entry for the constant. 

Scans constants chain for double word constants. 

Scans constants chain for single word constants. 

Scans constants chain for unaligned constants. 

Scans constants chain for constants used to initialize static 
storage. 

Controls the calling of the conversion routine CONVRT and pool scan 
routine POOLSC and, if required, I AD ENT. Also handles the case of a 
constant given in internal form. 

Checks for the end of the constant chain. 

Produces zero real (imaginary) part for CAD (corresponding Library 
module IHEUPA) . 

Produces zero real (imaginary) part for numeric field (IHEUPB) . 
Convert from bit string to bit string (IHEVSA). 

Convert from character string to character string (IHEVSC). 

Convert from character string to bit string (IHEVSD). 

Convert from character string to pictured character string (IHEVSE) . 


Produces a zero real or imaginary part for a constant given in 
internal form. 
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•Chart 09, Storage Allocation Logical Phase Flowchart 


****A1 ****♦•♦** 

* 09A2 • 




DETERMINES * 
♦ELIGIBILITY FOR* 
♦ STATIC DSA'S ♦ 


♦♦•♦♦B2********** 

♦STATIC 1 PD* 

•-*-*-*-*-♦-♦-•-* 

• SCANS TEXT • 

* SORTS STATIC * 

♦ CHAIN ♦ 


♦-•-*- «- *_ *-*-«.* 
♦ALLOCATES STOR ♦ 
♦AGE FOR STATIC * 
♦ARRAYS ( STRUCT* 


♦ALLOCATES SYM. ♦ 
♦TABLES AND DEDS* 
•FOR VARIABLES * 




* ALLOCATES 

* AUTOMATIC 

* STORAGE 


****«Q2* ********* 
♦PROLOGUES OF* 
».*-*.*.*.*.*.$.* 

* CONSTRUCTS • 

* PROLOGUES FOR * 
♦BEGIN, PROC, ON. * 
***************** 


***** 1 ) 2 * ********* 

♦ DYN. STORE QJ* 
*-*-*-*-*-*-*-*-• 
•SCANS TEXT FOR * 
•ALLOCATE t BUY * 

* STATEMENTS * 


*»»**j2* ********* 

•ALIGNMENT QU* 
*-*-*-*-*-*-*-*-* 

♦ SCANS PSEUDO- ♦ 

♦ CODE TEXT * 
♦ALIGNS OPERANDS* 


♦♦•♦Kl ♦*•♦*♦*♦* 

► 10A1 * 


.* LIST ♦. YES 

. AGGREGATE . * 

* . LENGTHS . * 


->• 


*»***K3* *•••*•*•• 

•LIST LENGTHS QX* 
»-*-*-*-*-*-♦-*-♦ 
PRINTS •- 
AGGREGATE * 
LENGTH TABLE * 


•***K4 *••••»*•• 

• < 
>* 1QAI • 
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Chart PA. Phase PA Overall Logic Diagram 


PICKUP HEAD ♦ 
OF ENTRY TYPE 1* 
CHAIN • 


Ctt •. 

.* WILL •. 
THERE bt 
->•. ANY .STATIC 
». OSA’C . 


• YES 

1 »»»» 

♦ PD • 

->♦ A1 


• SET OFF FLAG 

>• IN TliE 

•COMMUNICATION." 

♦ REGION 


°ICK UP 
NEXT ENTRY 
TYPE 1 


YES .»IT NEITHER •. 

♦. PROCEDURE NOR.< 

♦. BEGIN .♦ 


3 .♦ BLOCK SO *. 
-♦.FAR ELIGIBLE . 
FOR A STATIC* 
♦. DSA .♦ 


DVSIZE 

»****F3* ****•*•*• 

• SCAN THE • 
♦AUTOMATIC CHAIN* 

♦ TO CALCULATE • 
♦STORAGE RECUIRD* 
•FOR DOPE VECTRS* 


DSASIZE 

♦♦♦♦♦G3********** 

* CALC STORAGE ♦ 

* FOR VARIABLES • 
•STRUCTURES AND ♦ 

* ARRAYS * 


♦••**H3** *♦**•••♦ 

• ADD ♦ 

•STORAGE FOR STD* 
» DSA SLOTS TO * 

• COMPLETE DSA • 

• SIZE * 


SET 

ELIGIBILITY 
BIT OFF 
IN ENTRY 
TYPE 1 


> 51 ? 


CHAIN ENTRY 
FROM ENTRY 
TYPE 1 


DICENT 

•••••K ]• ♦••*••••• 

• MAKE STATIC ♦ 
•DSA DICTIONARY • 

• ENTRY FCR • 

* STATIC CHAIN • 
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Chart. PD. Phase PD Overall Logic Diagram 


•••••Al********** 

* SCAN TEXT • 

* AND * 

* REVERSE * 

* SECOND FILE * 

* POINTERS • 


SC SORT V 

•*»•**•*♦ 

SCAN STATIC * 
RAIN • 


CHAIN 

AND 




STATIC 

Cl *. 

• ♦SIMPLE *. 
.♦ STATIC 
*. INTERNAL 
*. VARIABLE 


•••••C2*«******* 


L 


. * >• 


♦. 


♦. 


. * 


ALLOCATE 

REQUIRED 

STORAGE 




.♦ IS A *. YES 

*. DOPE VECTOR .* 

•.REQUIRED .* 


••••♦D2 ********** 

• DETERMINE • 

• DV SIZE ♦ 

>• AND * 

• ALLOCATE * 

• STORAGE • 


A< 


. ♦ STATIC 
. EXTERNAL 
• .VARIABLE 


••••• 22 ••*•••*••* 

• ALLOCATE * 

• A A-BYTE ♦ 

->* ADDRESSING 

• SLOT 


71 

E3*»* 




SECTION 

PLACE IT IN 
• BXCT ENTRY * 


CONALC V 

•••••FI********** 
•SCAN CONSTANTS * 

• CHAIN AND * 

• RELOCATE • 

• OFFSETS IN * 
•CONSTANTS POOL • 


• BUMP LOCATION * 

• COUNTER BY • 

• SIZE OF POOL • 


HI *. 

.* ARE *. 
.•THERE MORE *. YES 

. CONSTANTS . • 

♦ . POOLS .* 


>« A1 

* * 
• ••* 
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Chart PH. Phase PH Overall Logic Diagram 



• * 

♦ ♦ • A 1 •••••••*•• 

A2 ♦. 

« * 

• • *A 3* ***** * 

• • 


PICK UP ♦ 


• 




START OK ♦ 

.♦ END OF •. NO 

• 

00 TO NEXT 



PROCEDURE. ♦ 


>♦ 

ITEM I.-' 


• ♦ 

BEGIN CHAIN ♦ 

* 

♦. CHAIN .♦ 

• . . • 

• 

• 

• • 

T!iK CHAIN 



CONSCH V 

♦ PICK HP 

♦ START OF 

♦ CONTROLLED 

♦ CHAU 


B3 •. 

• CAN ♦. 

IT HAVE ♦ . YES 

A DOPE . * 

VECTOR 


. ♦ 


. • 


♦ END OF 
CONTROLLED 
♦. CHA I N . 


* > 


GO TO 
NEXT HtM 
IN CHAIN 


ttm-^2********** 

♦ MAKE SKELETON 4 

♦ DOPE VECTOR * 
♦ENTRY. INCLUDE ♦ 
♦WHOLE STRUCTURE ♦ 

♦ IF NECESSARY ♦ 


♦♦•Kl****** 

CONTINUE 
SCAN OF 
STATIC 
CHAIN 


*** *1 ?******** ** 

PUT DOPE ♦ 
VICTOR ENTRY TN* 

STATIC CHAIN. ♦ 

ALLOCATE ♦ 
STORAGE ♦ 


♦ MAKE 3 KE l ETON « 

♦ DOPE VECTOR ♦ 
♦ENTRY. INCLUDE ♦<- 
•WHOLE STRUCTURE* 

♦ IF NECESSARY • 


YES .♦ ANYTH INC 

♦.Iil STRUCT JR!- 

♦. RSUUIHb . 1 


* INCLUDE DOPE 
♦VECTOR ENTRY V 

* STATIC CHAIN. 

* ALLOCATE 

* STORAGE 


.* SKELETON 
— >*. ARGUMENT 
*. LIST 


* *p 3*1 * *** *** 

ALLOCATE 
AMOUNT CF 
STORAGE. 
REQUIRED 


♦♦♦*G3********* 

ALLOCATE 
3TORAGE . 
CALCULATE 
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ELEMENTS 


*****GU********* 

* IF VIRTUAL 

* ORIGIN 1C -VI 
>* ALLCCATt 

* DFC.EUEnATL 

* DOPE VECTOR 


STKALO 
NO . • * 


*****H3*********< 

* ALLOCATE < 

* STORAGE. WORK < 
->* OUT JUKE EH OF < 

•ELEMENT IN ANY < 
•ARRAYS. (Iil PAH 


♦ ALLOCATE 

♦ DEGENERATE 

♦ r.CPl. VICTOR FOR 
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Chart PL. Phase PL Overall Logic Diagram 


DEDAL 1, DEDAL2 


♦♦•«lA2**»*«**»*» 


SCAN CHAIN 
OF STATIC 
VARIABLE'S 


♦<—*.< * 

♦ * 

* # 

M ♦ < 

♦ *** 


SCAN CHAIN 
OF CONTROLLED 
VARIABLES 


YES 


B2 ♦ . 

. * DOES * 

> VARIABLE 
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Chart PP. Phase PP Overall Logic Diagram 
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Chart PT. Phase PT Overall Logic Diagram 
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Chart QF. Phase QF Overall Logic Diagram 
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Chart QJ. 


Phase QJ Overall Logic Diagram 
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Chart QU. Phase QU Overall Logic Diagram 
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Chart QX. 


Phase QX Overall Logic Diagram 
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Table PA. Phase PA DSAs in STATIC Storaoe 


t t- 

Main Processing! 
Routine 


Statement or Operation Type 


| Scans Entry Type 1 chain for blocks 
| eligible for STATIC DSAs 

{Makes a dictionary entry for each 
| STATIC DSA 


Subroutines Used 


^ 


PADSA 


| DSASIZ, DVSIZE 


DICENT 


None 


+ 


| Sorts STATIC chain (called from PD) 

| Scans STATIC chain for INTERNAL 
j arrays; calculates number of 
j elements for those arrays needing 
j initialization. Allocates storage 
| for arrays and, if necessary, for 
| secondary dope vectors 


■+ 

| None 

4 

I None 


SC SORT 
ARRSCN 


Table PA1. Phase PA Routine/Subroutine Directory 


j Routine/Subroutine j 

[arrscn 


Function 


| DICENT 


I 
I 

| DSASIZ 

I 

j DVSIZE 


I PADSA 


SC SORT 


Scans STATIC chain for INTERNAL arrays; allocates storage for arrays! 
and secondary dope vectors (called from PH) . 

j Makes a dictionary entry for each STATIC DSA. 

I 

[Calculates size of DSA excluding Register Allocator Workspace. 

Scans AUTOMATIC chain for variables requiring dope vectors, and 
calculates size of dope vectors. 

Determines eligibility of a block for a STATIC DSA. 

Sorts STATIC chain (called from PD). 
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Table PD. Phase PD Storage Allocation Static 1 

r T 

Main Processing 

| Statement or Operation Type 

* 

| Reverses second file dictionary 
I pointers 

f 

| Sorts STATIC chain 

j. 

(Allocates storage for simple, 

| non- structured, non-external items 

(Allocates dope vectors for all 
j non-external items 

h 

(Allocates 4-byte addressinq slots; 

(calculates control section size for 
jail external items 

\r + 

| Allocates storage for constants. JCONALC 
L - J 


Routine 


Subroutines Used 


-H 

I 

I 

■H 


PD 


NXBLCK 


SCSORT (in PA) 
STATIC 


None 

SDSA1 


DVALOC 


None 


H 

I 

I 

H 

I 

I 

I 

H 

I 

j 


TVALOC 


STRCDV 


None 


Table PD1. Phase PD Routine/Subroutine Directory 

r T 

( Routine/Subroutine J 


Function 


I- - 
j CONALC 

T 

1 DVALOC 


J NXBLCK 


| PD 


j SDSA1 


J SCSORT 


\ STATIC 


1 STRCDV 


| TVALOC 


1 

1 


Allocates storage for constants. 

Allocates dope vectors for all non-external items. 

Obtains next text block. 

Scans text file and reverses second file pointers. 

Allocates a 4- byte address slot for each STATIC DSA. 

Sorts STATIC chain. 

Allocates storage for simple, non-structured, non-external items. 

Allocates relative offsets of structure member dope vectors. 

Allocates 4-byte addressing slots; calculates control section size 
for all external items. 


-H 


.-j 
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Table PH. Phase PH Storage Allocation Static 2 


Statement or Operation Type 


h 

| Scans AUTOMATIC chain; allocates 
j dope vector 


■ T 

| Main Processing 
Routine 

| PBSCAN 


h 


| Scans CONTROLLED chain 

(Allocates storage for skeleton 
j argument lists appearing in STATIC 
j chain 

[scans STATIC chain for INTERNAL 
j arrays; calculates number of 
j elements for those arrays needing 
| initializing. Allocates storage 
jfor arrays and, if necessary, for 
(secondary dope vectors 

(Scans STATIC chain for INTERNAL 
(structures, calculates number of 
j elements in structured arrays 
j needing initializing. Calculates 
jsize of storage for all structures 
jand bumps location counter. 






CONSCN | AUT04 , SKDV1, STRSCN 

SKARGL "^None 


ARRSCN (in PA) 


^STRALO 


Subroutines Used 


AUT04, SKDV1, S KENT 3, STRSCN, 
TEMPDV 


^ 


None 


— f — - — 
None 


H 
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Table PHI. Phase PH Routine/Subroutine Directory 


j Routine/Subroutine j Function | 

| ARRSCN (in PA) | Scans STATIC chain for INTERNAL arrays; allocates storage for arrays^ 

|and secondary dope vectors. 

i AUTEND | Tests for end of AUTOMATIC chain. 

I 

| AUT04 | Calculates size of dope vectors for dynamic temporaries and 

j CONTROLLED variables. 

I 

ICONSCN | Scans CONTROLLED chain. 

I 

ICSCN2 | Tests for end of STATIC chain. 

I 

| END513 | Stores STATIC location counter and releases control. 

PBSCAN j Scans AUTOMATIC chain; allocates dope vectors. 

I 

| PBS1 | Gets next item in chain. 

I 

SKARGL (Allocates storage for skeleton argument lists appearing in STATIC 

| chain. 

| SKARG1 j Allocates storage required. 

I SKDVl | Creates skeleton dope vector dictionary entries for non- structured 

| variables in AUTOMATIC and CONTROLLED storage. 

I 

SKENT3 |Constructs skeleton dope vector dictionary entries for function 

(values. 

ISTRALO j Calculates number of elements in structure arrays to be initialized; 

(calculates size of storage for all structures. 

I 

STRSCN | Creates skeleton dope vector dictionary entries for structures in 

(AUTOMATIC and CONTROLLED chains. 

I 

ITEMPDV (Creates skeleton dope vector dictionary entry for temporary 

(workspace. 
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Table PL. Phase PL Storage Allocation Symbol Table and DEDs 


I 


Statement or Operation Type 




{Allocates STATIC storage for all 
j symbol tables and DEDS 
— — — — - - ~ 

j IEMPL 

j 

| SCSCAN 

j 

j BCSCAN, CCSCAN, 

j 

CNSCAN, SCSCAN 

1 

1 

j 

| Scans STATIC chain for symbol and 
{DED variables 

i . ..... 

( DEDALl, STRSCN, 

I 

SYMTAB 

1 

1 

i 

1 

| Scans CONTROLLED chain for symbol 

{and DED variables 

• . . ... ........ 

j CCSCAN 

j 

{ DEDALl, STRSCN, 

1 

SYMTAB 

1 

1 

1 

j 

1 

| Scans PROCEDURE block chain of 

| BCSCAN 

| ACSCAN, DEDALl 


1 


j ENTRY type 1 entries 

h 


ACSCAN 


DEDALl, STRSCN, SYMTAB 


tsTRSCN 


j Scans AUTOMATIC chain for symbol 
jand DED variables 

{scans chain of members of 
{particular structure for symbol and 
{DED variables 

{Allocates storage for symbol tables 




j Allocates storage for DEDS 


+ 


I 


Main Processing 
Routine 


SYMTAB 


DEDAL (two 
entry points: 
DEDALl, DEDAL 2) 


Subroutines Used 




DEDALl, SYMTAB 


4 


DEDAL 2 
None 


H 

I 

-H 

I 

I 

I 

j 


Table PL1. Phase PL Routine/Subroutine Directory 


j Routine/Subroutine | 


Function 


I CCSCAN 


y 

| ACSCAN 

I 

| BCSCAN 

I 

1« 

I 

j CNSCAN 

I 

| DEDALl (PM) 

I 

| IEMPL 

I 

{ SCSCAN 

I 

j STRSCN 

I 

I 

j SYMTAB (PM) 

L 


Scans AUTOMATIC chain for symbol and DED variables. 

Scans procedure block chain of ENTRY type 1 entries. 

Scans controlled chain for symbol and DED variables. 

Scans constants chain for DED variables. 

Allocates storage for DEDs. 

Allocates STATIC storage for symbol tables and DEDs. 

Scans STATIC chain for symbol and DED variables. 

Scans chain of members of particular structure for symbol and DED 
variables. 

Allocates storage for symbol tables. 
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Table PP. Phase PP Storage Allocation Sort of AUTOMATIC Chain 


j entries 

| Scans AUTOMATIC ch< 
j ENTRY type 1 entry 


Statement or Operation Type 


ENTRY type 1 

(RAO 

1 

-j. 

j SETCH 

j 

from each 

j SETCH 

j 

| EXDT, 

j 

first 

j SC24 

j None 


j AUTOMATIC zone 

j Adds temporaries (type 2) and 
(independent items to first zone 

| Adds dependent items to subsequent 
j zones 

(Determines list of dependencies 
(from INITIAL attribute 

(Determines list of dependencies 
from DEFINED attribute 


(Determines list of dependencies for 
j array bound expressions 

^ 

(Determines list of dependencies for 
j string length expressions 


Main Processing 
Routine 


SC31 

SC44 

SC39 

SC40 

SC35 

SC50 

SCRUB1 


Subroutines Used 
SETCH, SCRUB1, SORCH 


1 

^ 


SCNCHN, SRCH2 
SCNCHN, SRCH2 
EXDT, SCNCHN 
SCNCHN, SRCH2 

None 


\ 

j 

^ 


Removes independent item dictionary 
references upon which items in the 
AUTOMATIC chain depend. 




Table PP1. Phase PP Routine/Subroutine Directory 


j Routine/ Subrout ine j 


| EXDT 


|RAO 


| RA1 


|RA4 


| RA7 


| SCNCHN 


| SCRUBI 


| SC24 


| SC31 


| SC35 


JSC39 


| SC40 


| SC44 


| SC 50 


| SETCHN 


| SORCH 


| SRCH2 

l _ — 



Function 

Scans dimensions tables for second file statements with adjustable 
bounds. 

Scans BEGIN- ENTRY for entry type 1 entries. 

Tests for end of ENTRY type 1 chain. 

Creates an AUTOMATIC chain delimiter. 

Tests for end of chain. 

Scans current AUTOMATIC chain; determines whether reference belongs 
to it. 

Removes independent item dictionary references from the stack of 
dictionary references upon which items in the AUTOMATIC chain 
depend. 

Adds ON conditions to first automatic zone. 

Adds temporaries (type 2) and independent items to first zone. 
Determines list of dependencies for array bound expressions. 
Determines list of dependencies from INITIAL attribute. 

Determines list of dependencies from DEFINED attribute. 

Adds dependent items to subsequent zones. 

Determines list of dependencies for string length expressions. 

Scans AUTOMATIC chain from each ENTRY type 1 entry. 

Sorts chain in order of dependencies; creates zone delimiter 
dictionary entries. 

Scans second file statements for dictionary references of labels, 
data items, and structures, which may belong to the current 
AUTOMATIC chains. 
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•Table PT. Phase PT Storage Allocation AUTOMATIC Storage 


1 

| Statement or Operation Type 

L_ 

|Main Processing! 

9 Routine { 

—L X 

Subroutines 

Used 

■ 

| Scans stacked CONTROLLED chain for 
(largest dope vector 

|'mynam 

1 

1 

j DVSIZE 
1 

| T 



(Initializes ENTRY type 1 chain scan|DSALOC 
j and DSA | 

(Allocates slots for ON conditions |DSA4 

{ MKSTAT 
1 

+ 

j MKSTAT 

^4-^--- .. 

— 


(Allocates storage for workspace and|DSA10 
jfor DSA addressing vector j 

{scans AUTOMATIC chain and allocates j DSA16 
j storage for dope vectors j 

T * 

| None 

j 



(COPY, 
j STD VI N 

DVSIZE, INITDV, 

MKSTAT, 

r 

(Allocates BUY workspace 

j DSA17 
| 

{ None 

_L 



{Allocates storage for parameters 

j DSA19 

| None 

.j. 



{Allocates storage for double 
j precision variables 

i . 

| DSA25 

1 

| None 

}None 

j 



r 

(Allocates storage for single 
j precision variables 

{Allocates storage for character 
j strings and halfword binary 

{ DSA29 

J 



| DSA38 

1 

( None 

j 



{Allocates storage for bit strings 

.j. 

j DSA46 

{ None 



(Allocates storage for arrays and 
(secondary dope vectors 

(Allocates storage for structures 

|Gets VDA and initializes dope 
j vectors for adjustable regions of 
{AUTOMATIC chain 

{ DSA54 
[ 

| DSA68 

| COPY, 

j 

INITDV, MKSTAT, 

SDVCDE 

j COPY, 

MKSTAT 


(DSA72 

1 

1 

|cOPY, 

1 

1 

INITDV, MKSTAT, 

STD VI N 


(Allocates storage for DEFINED items |DSA98 | None | 
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•Table PTl . Phase PT Routine/Subroutine Directory 


[Routine/Subroutine 


(CONTI 

| 

| COPY 


|DSALOC 


(DSA4 


|DSA5 


| DSA10 


(DSA16 


| DSA17 


| DSA19 (PU) 


| DSA25 (PU) 


| DSA29 (PU) 


| DSA38 (PU) 


| DSA46 (PU) 


|DSA54 


| DSA 6 8 


| DSA 7 2 


|DSA74 


| DSA98 


| DSA161 


| DSA162 


| DSA952 


| DVSIZE (PU) 


| INITDV 


| MKSTAT 


| MY NAM 


| SDVCDE (PU) 


| STDVIN 

J. 


Function j 


Scans controlled chain for size of longest dope vector. 

Compiles code to copy skeleton dope vector into real dope vector. 
Initializes ENTRY type 1 chain scan and DSA. 

Allocates slots for ON conditions. 

Allocates standard save area and flag bytes. 

Allocates storage and workspace for DSA addressing vector. 

Scans AUTOMATIC chain and allocates dope vectors. 

Allocates BUY workspace. 

Allocates storage for parameters. 

Allocates storage for double precision variables. 

Allocates storage for single precision variables. 

Allocates storage for character strings and halfword binary. 
Allocates storage for bit strings. 

Allocates storage for arrays and secondary dope vectors. 

Allocates storage for structures. 

initializes dope vectors for adjustable regions of AUTOMATIC chain. 
Stores pointer to skeleton second file statement. 

Allocates storage for DEFINED items. 

Allocates storage required for dope vectors. 

Compiles code to initialize dope vectors. 

Gets VDA for this region of AUTOMATIC chain if required. 

Determines size of dope vectors. 

Compiles code to initialize address slot in dope vector. 

Makes a second file statement. 

Scans CONTROLLED chains. 

Compiles code for secondary dope vectors. 

Initializes structure member dope vectors. 


J 
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Table QF. Phase QF Storage Allocation Prologues 

I (Main Processing! ] 

j Statement or Operation Type | Routine j Subroutines Used | 

j Scans text for statement labels, (QF0000 JQBEGEP, QBPROL, QEOP, QMOVE, QPROL, | 

(PROCEDURE statements, BEGIN j j QSL | 

(statements, BEGIN END statements, j j | 

jand end- of -prog ram marker j j ( 

(Processes statement label (QSL | QMOVE j 

j pseudo-code items ( j | 

| Frees text storage at end of phase; J QEOP j QMOVE j 

j releases control | j | 

(Creates stereotyped prologue for a (QBPROL IQADJAL, QFSKIP, QF0201, QMOVE | 

j BEGIN block requiring a dynamic | ( | 

j storage area j j | 

| Creates stereotyped or special (QPPROL (QADJAL, QFSKIP, QF0201, QMOVE, | 

j prologues for PROCEDURE statements,! j QONPRL j 

(depending on conditions. Processes! j j 

j statement label pseudo-code items j j j 

( + 1 - ^ 

| Creates a compiler label marking | QBEGEP IQADJAL, QF0201, QMOVE | 

jthe return from a BEGIN block j j | 

| Creates a prologue for ON block | QONPRL IQADJAL, QFSKIP, QF0201 | 

| Assembles code to initialize DSA j QADJAL | QM0VE1 j 

jdope vector data areas, and to j j j 

| allocate variable data areas j j j 

j Skips second file statements j QFSKIP |None | 

(following a block heading statement! I I 

j Obtains new buffer and chains it to|QF0201 |None j 

jthe previous one j j j 

(■— + -+ \ 

(Moves input text being skipped from| QMOVE | None | 

(input buffer to output buffer j j j 

| Moves a second file statement, jQMOVEl j QMOVE j 

| pointed at by PARI, to the prologue j j j 

| being generated j j I 
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Table QF1. Phase QF Routine /Subroutine Directory 

(Routine/Subroutine | Function ] 


r — - 
QADJAL 


(Assembles code to initialize DSA dope vector, variable data areas, 

jand to allocate variable data areas. 

1 

— 1 

QBEGEP 


1 

| Creates a compiler label marking the return from a BEGIN block. 

I 


QBPROL 

(QG) 

(Creates stereotyped prologue for a BEGIN block requiring a dynamic 
(storage area. 

I 


QEOP 


1 

(Frees text storage at end of phase; releases control. 

i 


QFSKIP 

CQG) 

1 

(Skips second file statements following a PROCEDURE or BEGIN 
(statement. 


QFOOOO 


1 

| Scans text for statement labels, PROCEDURE statements, BEGIN 
(statements, BEGIN END statements, and end-of-program marker. 


QF0201 

(QG) 

1 

| Moves code to output buffer; obtains new buffer if required. 

i 


QF0360 


| Tests for external procedure. 

i 


QF0370 


1 

(Generates prologue for GET DSA. 

1 


QF0570 


i 

(Generates code to copy argument and target addresses. 

i 


QF0625 


1 

| Tests for entry points. 

i 


QF0860 


| Tests end of chain. 

i 


QF1172 


I 

| Tests end of first region. 

i 


QF1194 


1 

(Extracts mapping code from second file. 


QF1215 


1 

| Tests for storage required. 

i 


QF1511 


1 

| Removes VDA accumulator assignment code from mapping code. 

i 


QMOVE 


1 

| Moves text from input buffer to output buffer. 

■ 


QMOVE1 


1 

| Moves second file statement to prologue being generated. 

i 


QONPRL 

(QH) 

(Creates prologue for ON block. 

i 


QPPROL 

(QG) 

1 

| Creates stereotyped or special prologues for PROCEDURE statements, 
(depending on conditions. 

i 


QSL 

L 


1 

(Processes statement label pseudo- code items. 

j 
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Table QJ. Phase QJ Storage Allocation Dynamic Storage 
r 


General scan of text for ALLOCATE, 
BUY and FREE statements 

K 


Statement or Operation Type 


Main Processing 1 

Subroutines Used 

ALLOC, BUY, BUYP, FREE, TRF1. ^ 


Routine 


GS1 


+— 


~4 


H 


Allocates items not requiring dope 
vector 


AL20 


AL15, TRF2 


+ 


Generates code to move skeleton 
dope vector into workspace for 
controlled variables 


MOVEDV 


TRF2 


Looks ahead to reverse pointers for 
ALLOCATE statements 


REVPT 


GS1, TRF1 


+ 

GS1, LIBC1, LIBC2, SCANSF, TRF2 


Allocates storage for controlled 
string 

Allocate storage for controlled 
array 

Allocates storage for controlled 
structure 


AL28 

+ 

AL27 

4. 

AL29 


ABOUND, LIBC1, MOVEDV, PREVAL, 
SCANSF, TRF2 

BNDEXP, LIBC1, MOVEDV, NXTREF, 
NXTVAR, PREVAL, SCANSF, TRF2 

-4 


4 


Loads Library call parameter 
register to free allocated storage 


FREE 


TRF2, TRF3 


+ 

BUYP 


-4 


Moves skeleton dope vector for 
bought temporary 


TRF2 


+ 

BY14 


Buys storage for temporary array 


SCANSF, TRF2 


^ 

LIBC4, NXTREF, NXTVAR, SCANSF, TRF2 


Buys storage for temporary 
structure 


BY13 


Places initial value code line for 
controlled variables 


AL15 


NXTRF, SCANSF 


-4 


+ 

GSl 


-H 


Skips scan register over 
initialization statements 


SKIPTX 


-4 


h 


Generates code to set a pointer to 
the previous allocation. 


PREVAL 


TRF2 




Searches dimension tables for 
adjustable bound expressions 

Generates code for temporary 
variables requiring only a dope 
vector 


ABOUND 

^STMP 


SCANSF 

+ 

LIBC3, TRF2 


4 


-_J 
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Table QJ1. Phase QJ Routine/Subroutine Directory 


j Routine/Subroutine j Function 


| ABOUND (QK) 

I 

| ALLOC (QK) 


j AL20 (QK) 

I 

j AL27 (QK) 

I 

| AL29 (QK) 


I BNDEXP 


| FREE (QK) 


I LIBC1/LIBC2/LIBC4 


j MOVEDV (QK) 


jNXTREF (QK) 

I 

j NXTVAR (QK) 

I 

|PREVAL (QK) 


IREVPT 


I SCANSF 


SKIPTX 


| STMP (QK) 


Searches dimension tables for adjustable bound expressions. 

Ascertains the type of allocate statement. 

Places initial value code line for controlled variables. 

Allocates items not requiring dope vector. 

Allocates storage for controlled arrays. 

Allocates storage for controlled structures. 

Generates or extracts code to set the adjustable bounds of 
structures . 

Ascertains the type of buy. 

Moves skeleton dope vector for bought temporary. 

Buys storage for temporary structure. 

Buys storage for temporary array. 

Buys storage for temporary string. 

Loads Library call parameter register to free allocated storage. 

General scan of text for ALLOCATE, BUY, and FREE statements. 

Places the library calling sequence for controlled storage in 
sequence in the text. 

Generates code to move skeleton dope vector into workspace for 
controlled variables. 

Obtains the next structure base element reference. 

Obtains the next varying array base element reference. 

Generates code to set a pointer to the previous allocation. 

Looks ahead to reverse pointers for ALLOCATE statements. 

Places second file statement in the line in the text. 

Skips scan register over initialization statements. 

Generates code to buy storage for temporary variables which only 
require a dope vector. 

Transfers input text to output. 

Adds text skeletons to the output text. 

Adds the Library Calling sequence to the output text. 
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•Table QU. Phase QU Alignment Processor 

| Main Processing 

Statement or Operation Type | Routine 




ALIGNQ 


ALREGQ , MVCMAK, REGENT 


MVCMAK 


ABEOT , NEXREG f OUTEST , PSMOVE , REMOVE , 
SNEXT, TRANS 


H 


Tests pseudo-code instructions for 
misaligned operands and deduces the 
correct alignment 

Generates a move character (MVC) 
instruction for a misaligned 
operand 

\ ' - ^T3 

TLA 


Skips a pseudo- code item 


Processes the load address (LA) 
pseudo- code instruction 


Processes the library calling 
sequence in the pseudo- code 


+ 

TLTB 


Subroutines Used 


1 


TNEXT 
TRR 


ABEOT # T3 


■H 

I 

I 

■H 


ALIGNQ, ALREGQ, OUTEST, PSMOVE , REMOVE , ^ 
SNEXT, TRANS, TRR 

ALIGNQ, TRRS 


Processes the L pseudo- code 
instruction 

Processes pseudo-code instructions, 
other than L and LA, that may have 
misaligned operands 

Examines a pseudo- code item and 
passes control to the appropriate 
processing routine 


TLL 


+ 

THT 


^TRANS 


~^T3 , TABS , TDROP, TEOP , THT , TLA , TLIB , ^ 

TLL,TRR,TSN 
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•Table QU1 . Phase QU Routine/ Subroutine Directory 

| Routine/Subrout inej Function | 

j ABBOT j Outputs termination error message. | 

I I I 

| ALREGQ | Tests whether or not the register is in the register table. | 

I I I 

| NEXREG | Gets a symbolic register. | 

I I I 

JOUTEST | Gets a new output text block if reguired. | 

I I I 

| PSMOVE | Fills current output text block and gets a new one. | 

| REGENT | Makes an entry in the register table for a register that has been | 

| j loaded with the address of a misaligned operand. | 

I I I 

| REMOVE | Copies text into the output text block. | 

JSNEXT j Accesses next pseudo-code item in the source text. j 

I I I 

| TABS | Scans absolute code and copies it onto the output text if necessary. | 

I I I 

jTDROP | Removes dropped registers from the register table. | 

I I I 

JTEOB I At the end of a source text block, moves out the scanned text and | 

j j gets the next source text block. | 

I I I 

| TEOP | At the end of the program, outputs the remaining text, and releases | 

j | control. | 

I I I 

|TRR | Deletes an assigned register from the register table. | 

| TSN | Updates the statement number slot in the communications region. j 


Chapter 3s Flowcharts, Tables, and Routine Directories 343 



Table QX. Phase QX Print Aggregate Length Table 


Statement or Operation Type 


(Scan storage chains in dictionary |SCANC 
j for aggregate entries f 

* + 

| Analyze aggregate dictionary | ANAGG 

j entries and print table entry | 

L J 


|Main Processing! 
I Routine j 


— i 


Subroutines Used 


| ANAGG, PRNTAB 

I 

1 1 

j ANCOB , EXTENT f FINALA f FIRSTA , FORMAL , 
j GETVO, GETSB, MAKEN , PRHED , SORTEN , 
j VOPLUS 


Table QX1. Phase QX Routine/ Subroutine Directory 


| Routine/Subroutine | 
| ANAGG 

ANCOB 

EXTENT 

FINALA 
FIRSTA 
FORMAL 
GETVO 
GETSB 
MAKEN 
PRHED 
PRNTAB 
SCANC 

SORTEN 

VOPLUS 


Function | 

4 


[Analyzes dictionary entries for a major structure or non-structured 
array. 

(Finds original major structure dictionary entry for a COBOL major 
structure. 

j Calculates length in bytes of a data variable, label, task, event, 
lor area. 

I 

(Calculates address of final basic element of a major structure. 
(Calculates address of first basic element of a major structure. 
(Calculates length of a non-structured array. 

Gets virtual origin of a dimensioned variable. 

Sets pointer to BCD in a dictionary entry. 

(Makes an entry in text block for each aggregate. 

| Prints main heading and sub-heading of table. 

I 

j Prints Aggregate Length Table. 

Scans STATIC, AUTOMATIC and CONTROLLED chains in dictionary for 
aggregate entries. 

Sorts text block entry for aggregate so that the entries are chained 
in collating sequence order of the aggregate identifiers. 


Calculates address of first or last element of major structure. 


._j 
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•Chart 10. Register Allocation Logical Phase Flowchart 


♦FIRST SCAN RA* 

♦ ESTABLISH ♦< 
♦ADDRESSIBILITY ♦ 


♦•♦•A2****^**** 


♦SET UP TABLE TO* 
♦DEAL WITH BQU* S* 


••♦••Cl* ♦♦******• 

♦SECOND SCAN RF* 
*_*-♦-*_*-*-•-•-* 

♦ ALLOCATE ♦ 

* PHYSICAL • 

• REGISTERS ♦ 
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Chart RA . Phase RA Overall Logic Diagram 
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ACT7 
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•Chart RD. Phase RD Overall Logic Diagram 
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Chart RF. Phase RF Overall Logic Diagram 
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LB 
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• CONSTRUCT • 

• COMPLETED • 

— >;INSTRUCT^N AND*<- 


GENERATE 
STORKS OF 
REGISTERS 




YES 
’ *, 

.* *. 

. * BRANCH *. NC 
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’ ' 


»*!*« 
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>* REGISTER TO 


F4 


NO 

’*, 


SOME 

.* REGISTERS ♦ . YES 
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•.STORE.* 

*. .* 



♦**»*G3** ******** 

* EXPAND * **•* 

* ADDRESSING * * * 

->* INSTRUCTIONS * >* Bl ♦ 

♦ IN OUTPUT * * * 

• • •••* 


J1 
. IPRtV 


.♦ DROP, *. YES 
>1', EPRM .* 
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LEND 

*#***B2* ********* 

* UPDATE * 

* OR DOWNDATE • 
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* BLOCK ENTRIES * 

* • 
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| **•* 
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348 



Table RA. Phase RA Register Allocation Addressibility Analysis 


I 

| Statement or Operation Type 
| Controls scan of source 

I 


Main Processing 
Routine 


Subroutines Used 


+ 

ILAA 


4 

j ACT1, ACT2 , ACT5, ACT8, ACT9, 
j ACTIO, ADCBUF, GETSBF 



[processes rx, rs, or si {act3 {adtest, drtest "j 

j instructions | | | 

(Processes SS instructions |ACT4 j ADTEST, DRTEST | 

[compiles code for start of PL/I |ACT15, ACT14, | ADCBUF, GENFLP, UPSN \ 

(Statement: 1. with label, 2. |ACT16 j | 

j without label, 3. compiler label j j | 

(Processes PROCEDURE and BEGIN |ACT6 | ADCBUF | 

(blocks | ( | 

(Processes END statements on |ACT7 j ADCBUF j 

(PROCEDURE or BEGIN blocks ( j | 

| Adds text to output string (ADCBUF | GETCBF | 

(Adds text to insertion file (ADIBUF (GETIBF | 

{obtains new source buffer j GETSBF (None j 

| ■(■ f ^ 

(Obtains next output buffer (GETCBF |None | 

J. 1 f ^ 

| Obtains next insertion file buffer | GETIBF (None | 

(Excunines dictionary reference in (DRTEST {aDINST, DECOMP, SETBLK j 

{ source j j j 

(Produces recovery code when literal j ADTEST j ADCBUF | 

(offset greater than 4095 is met j j j 

(Creates coded addressing (ADINST (ADCBUF, ADIBUF j 

j instructions j j 'I 






"N 
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Table RA1 . Phase RA Routine/Subroutine Directory 

I T 

| Routine/Subroutine | Function 


| ACTl 

| Copies non-special three- byte item to output. 

I 



^ 

| ACT2 

1 

| Copies non-special five- byte item to output. 

1 




JACT3 

j Processes RX, RS, or SI instructions. 




| ACT4 

j Processes SS instructions. 




| ACT5 

i 

|End of block routine. 




| ACT6 

j Processes PROCEDURE and BEGIN blocks. 

1 




j ACT7 

1 

| Processes END statements on PROCEDURE or BEGIN blocks. 

i 




| ACT8 

1 

| End of source text routine. 

1 




| ACT9 

j Action of start of common block of prologue. 

i 




| ACTIO 

1 

| Action at end of prologue. 

1 




| ACTl 2 

I 

(Copies absolute code to output stream. 




| ACTl 3 

| Creates ADI instruction at prologue insertion point. 




| ACTl 4 

(Compiles code for start of PL/I statement with label. 




j ACTl 5 

(Compiles code for start of PL/I statement without label. 




| ACTl 6 

(Compiles code for start of PL/I statement compiler label 

• 



| ADD/ADD 2 

(Generates store of calculated address. 




| ADCBUF 

|Adds text to output string. 

1 




| ADIBUF 

(Adds text to insertion file. 




J ADINST 

(Creates coded addressing instructions. 




| ADTEST 

(Produces recovery code when literal offset greater than 

4095 

is 

met. j 

| ATD 

(Tests whether previous offset is out of bounds. 




| DECOMP 

1 

| Decodes dictionary reference. 

1 




| DRTEST CRB) 

(Examines dictionary reference in source. 




| DTY 

| Scans step table and generates addressing instructions. 




| GENFLP 

(Generates code to set bits on and off in a prefix ON— slot. 



| GETCBF 

| Obtains next output buffer. 




| GETIBF 

| Obtains next insertion file buffer. 




| GETSBF 

| obtains next source buffer. 

1 




| LAA 

1 

| Scans input text. 

I 




| LI 25 

| Moves addressing instructions to IN-LINE. 




| SETBLK 

| Finds block number of referenced item. 




| UPSN 

(Generates code to keep the statement number slot in the 
j date . 

i 

< 1 

(0 1 

Q 1 

up 

to | 
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•Table RD. Phase RD Use Determination of all EQUs 

[Main Processing 

Statement or Operation Type 


| Scans text | LBUILD |LEQV, LBC, LBAL, LOBR, LEOB , j 

LABS, L3BYT, L5BYT, LVARB, 

LSTAT, L2BYT, LEOP 

— f 4 

LEQU | FNDIND 

4 

LBC I FNDIND 


j. 4 — 

Processes EQU items 
Processes BC items 




Processes BAL items 




Skips a 2-byte item 


Initializes text blocks for tables 


4 4 


Processes any other branch item 






Skips a 3-byte item 


| L2BYT 
IL3BYT 


h 

Skips a 5-byte item 


Skips a variable length item 


Processes a statement number item 


Processes an EOB item 
Scans absolute code 


Flags EQUs in text as optimizable 


Routine 


LINIT 


LBAL 


LOBR 


L5BYT 


LVARB 


+ + 


LSTAT 


^LEOB |None 

4 + 

LABS I None 


Finds the indicator byte and text 
reference of an EQU value 

h 

Ends table build and passes control 
to second section 

Scans tables for optimizable EQUs 


FNDIND 

^LEOP 


4 

LSCAN 




LFLAG 


Subroutines Used 


None 


4 


LOBR, L5BYT 


FNDIND 
None 
None 


4 y 4 


None 
None 


None 


■H 

I 

■H 

I 

■H 


None 

LSCAN 


— I- 

LFLAG 


None 
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•Table RD1. Phase RD Routine/Subroutine Directory 

r* 


j Routine/Subroutine | 
I FNDIND 




I 

| LABS 

I 

j LBAL 

I 

j LBC 

I 

| LBUILD 

I 

|LEOB 

I 

|LEOP 

I 

|LEQU 

I 

j LFLAG 

I 

| LI NIT 

I 

j LOBR 

I 

j LSCAN 

I 

j LSTAT 

I 

j LVARB 

I 

| L2BYT 

I 

j L3BYT 

I 

j L5BYT 

L 


Function 

Finds indicator byte and text reference of EQU value 

Scans absolute code 

Process BAL items 

Processes BC items 

Scans text 

Processes EOB items 

Ends table build and passes control to second section 
Processes EQU items 
Flags EQUs in text as opt imiz able 
Initializes text blocks for tables 
Processes any other branch item 
Scans tables for optimizable EQUs 
Processes statement number items 
Skips variable length items 
Skips 2- byte items 
Skips 3- byte items 
Skips 5- byte items 
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Subroutines Used 


Table RF. Phase rf Register Allocation Physical Registers 


j Statement or Operation Type 
| Controls scan of text 


[processes PROCEDURE or BEGIN 
j statement 


(Main Processingj 
J Routine j 

|Z9 [aDCBUF, ADIMOV, BR1, BR3 t BR4, ] 

j j GETNXT , LBAL, LBALR, LBCTR, LEOB, | 

j j LEOP, LR1, LR3, LR4, LR6 , LR7, LR9 , | 

j j L SHI FT, OBREGS j 

| LPROC | None ] 


j Processes end of PROCEDURE or BEGIN j LEND |None 

| block | 

(Processes requests for registers; | OBREGS |BRGUSE, LOADl, STORE1 , STORE2 , | 

(allocates physical registers j j REGUSE j 

j Compiles code to store symbolic j STORE 2 | ADCBUF j 

| registers j | j 

(Compiles code to store assigned (STORE1 (ADCBUF | 

j registers j j j 

j Compiles load of physical registers j LOAD1 | ADCBUF j 

(Compiles load register | LOADRG | ADCBUF | 

j Expands coded addressing j ADIMOV j ADCBUF j 

j instructions j j j 

h * ^ + \ 

| Adds to output buffer | ADCBUF |None | 


Table RF1. Phase RF Routine/Subroutine Directory 


| Routine/Subroutine ( 

(ADCBUF | Adds to output buffer. 

I t 

| ADIMOV | Expands coded addressing instj 

I I 

| BRGUSE (Tabulates use of base registe] 

I I 

|BR1 (RH) (Processes RX branch instructi< 

I I 

| BR3 (RH) (Processes BCT instructions. 

I I 

|BR4 (RH) (Processes RR branch instructi< 

I I 

IFRTEST | Scans list of free registers 1 


Function 


j GETNXT 

I 

j LADl (RH) 

I 

| LB (RH) 
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Table RF1. Phase RF Routine/Subroutine Directory (cont'd) 

| Routine/Subroutine | Function 


| LBAL (RH) 

(Processes BAL instructions. 


1 

| LBALR (RH) 

1 

(Processes BALR instructions. 

i 



|LBCTR (RH) 

1 

(Processes BCTR instructions. 



|LDROP (RH) 

1 

(Processes DROP pseudo- instruction. 

1 



|LEND (RH) 

1 

j Loads end of PROCEDURE or BEGIN block. 

i 



| LEOB (RH) 

1 

(Processes end-of-block marker. 

i 



| LEOP 

1 

(Processes end-of-program marker. 

1 



| LOAD1 

1 

(Compiles load of physical registers. 

i 



| LOADRG 

1 

(Compiles load register. 

i 



| LPROC (RH) 

1 

(Processes PROCEDURE or BEGIN statement. 



| LR1 (RH) 

i 

(Processes instructions in which first and second operands 

j loading, and the first is altered, e.g., AR. 

1 

require 

| LR3 (RH) 

i 

(Processes floating-point instructions. 

i 



| LR4 (RH) 

1 

(Processes SS instructions. 


i 

| LR6 (RB) 

j Processes instructions where a load of first operand 

(operands are changed, e.g., ST. 

■ 

is required, no| 

JLR7 (RH) 

1 

(Processes SI instructions. 



| LR9 (RH) 

(Processes instructions in which no load of first operand 
jand it is changed, e.g., LA. 

i 

is needed. 

ILSHIFT (RH) 

(Processes shift instructions. 



| OB560 (RG) 

(Tests whether all registers are available. 



| OB630 (RG) 

(Generates stores of registers if branch in or out. 

I 



(OB895 (RG) 

1 

(Generates code to load registers. 



|P9INIT (RH) 

j Main text scan. 



|OBREGS (RG) 

(Processes requests for registers; allocates physical 

registers. 

| REGUSE 

(Tabulates use of registers in look ahead. 

1 



| STOREl 

(Compiles code to store assigned registers. 

1 



| STORE 2 

(Compiles code to store symbolic registers. 

1 



|W4 (RH) 

(Extracts ADIs at prologue insertion point. 

1 



| Z9 (RH) 

1 

(Controlling scan of text. 
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• Chart 11. Final Assembly Logical Phase Flowchart 
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Chart TF. Phase TF Overall Logic Diagram 
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I *•♦• 
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->♦ CURRENT TOTAL •- 
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IL0015 
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* OFF (PCBS) 


.* NON-BRANCH *. YES 

MACHINE . * 

*. INST .* 


.* BRANCH *. YES 

♦ .OR LOAD ADDR .* 

* . INST . * 


ILOOltt 

****«F2* ********* 

« ADD LENGTH OF * 

♦ INSTRUCTION * 
>♦ TO LOCATION ♦- 
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IL0019 

* **** B 2 ********** 
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356 



Chart TJ. Phase TJ Overall Logic Diagram 



,* *. YES 

• . procedure .* 

*. MARKER .* 


.♦ END OF ». YES 

* . PROCEDURE . « 
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.* MACH. *. 
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Chart TO. 


Phase TO Overall Logic Diagram 
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Chart TT. Phase TT Overall Loqic Diaqram 
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Chart UA. 


Phase UA Overall Logic Diagram 
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Chart UD. Phase UD Overall Logic Diagram 
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H3 *. 

* * 

CORRES- 


1 


***** 
*UE * 
* A3* 


STRUCTURE 


***«*JM«****».*** 

* GENERATE TXT * 

* CARD DOPE * 

♦ VECTOR AND * 

♦ RLD CARD FOR * 
•VIRTUAL ORIGIN * 


*...*HS********< 

* GENERATE 

* TXT CARD 
->♦ FOR STRUCTURE 

* DOPE VECTOR 


»..*.J5** •••****» 

* SCAN BASE * 

* ELEMENTS • 

• GENERATING * 

• RLD CARDS FOR • 
•VIRTUAL ORIGINS* 
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Chart OE. Overall Logic Diagram 


.# 

. . ♦ 

♦ NO 




iUU . f 

•****c 5* 


.* SIMPLE ♦. YES • 

->* . DATA VARIABLE. * >• PROCESS ITEM 

* .OR LABEL .* • 


. * END OF *. YES 

->* .THIS PART OF .* 

♦. SCAN .* 

*. .* 


« ^ « *E1 ♦ + ♦**♦*%*♦ 

* * 

* * 

♦ GET NEXT ITEM *<- 

♦ * 

* * 

***************** 


E2 *. 

. * DOES * . 
ITEM 

NEED DOPE 
. VECTOR . 
* . . * 
*. .* 


*****F2 ********** 
* * 

* * 

* PROCESS ITEM * 

* * 

* * 

***************** 



**i**F5*i******** 


***************** 







* 

GET NEXT ITEM 

* 


* 

* 

*4 


* 

»* 


***** 
♦UF * 
* Al* 


*****j 3* ********* 


***************** 


NO 

J4 *♦. 

. * *. 

.* IS ITEM ♦. YES 

— >*. INITIAL .♦ 

• . •* 
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Chart UF. Phase UF Overall Logic Diagram 


♦INITIALIZATION. ♦ 
•TRANSLATE TEXT • 
•TO EXTERN CODE ♦ 


IL0003 

»****B1 ********** 

* GET BRANCH • 

* LIST INDEX • 

* PRON TABLE 1 •< 

* USING CURRENT • 

* OP CODE • 


IL0002 il 

•****B2* ••******• 

• GET LENGTH OF * 

• CURRENT ITEM « 
• FROM TABLE 2. • 

• BUMP « 

• INPUT POINTER « 


ILOOXO 

•***«C2*** ******* 

* SAVE CURRENT * 

* LOCN CTR IN * 
>* LOCN1 SLOT Or •- 

• CONTAINING * 

♦ PROCEDURE ET1 • 


END OF *. YES 

PROCEDURE . * 

. MARKER .* 


IL00X1 

•**D2*** ******** 
PRINT * END 
•PROCEDURE AND * 

> ENTRY NAMES — 

* AND STATEMENT* 
NUMBER 


IL0015, 

IL0016 

***E2* ********** 

PRINT PROLOGUE 
* OR * 

> PROCEDURE BASE. — 

* SET ♦ 

LOCN CTR * 0 
****»*•***•**••• 


IL0012.IL0013, 

&88U:&8j|29: 

IL0028IL0032 

*««t*F2* ********* 
♦SET UP LOCATION* 

* COUNTER AND * 
>♦ MNEMONIC AND *- 

* HEX OP CODES ♦ 

* IN BUFFER * 
***************** 


•****C3** ******** 

* SET LOCN CTR * 

* TO ZERO AND * 
->*PROCLC ( COUNTER •- 

* BASE) FROM * 

* LOCN 5 IN ET1 • 


*•***03* ********* 

• RESTORE LOCN 
FROM 


PRINT 

• ♦ PROCEDURE 
FOLLOWED BY 
ENTRY NAMES 
AND STAT NO. 


* counter From * * * 

>* L0CN1 AND * >* B2 * 

* PROCLC FROM * A * * 

* LOCN 3 ♦ L0CN5 * 


PRINIT 

***E3* ********** 
PRINT LIST 
* OF ADCONS * 


IL2005 

NM0003 

•****F3* ***•*•••* 

* IDBJTIFY * 

* OPERANDS AND * 
>* EXPRESS IN *- 

•TERMS OF SOURCE* 

* IDENTIFIERS * 


•**F4 *********** 

PRINT LINE 
* AND ♦ 

INCREMENT 
LOCATION * 
COUNTER 


.* LABEL *. YES 

• .OR STATEMENT .* 

* . NUMBER . * 


IL0018, 

IL0019 

***G2*»* ******** 
PRINT STATEMENT 
* NUMBER * 

> AND ANY LABEL — 

* IDENTIFIERS * 


**•* 

* • 

* B2 * 

* • 
♦ **♦ 


.♦IS COMPILER*. YES 

* . SUBROUTINE . * 

*. WANTED .* 


•••••••A********* 


*****K3« •**••••** 




♦PRINT LINE WITH* 

♦ OPBIATION * 

* MNEMONIC END • 
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Chart XA, Phase XA Overall Logic Diagram 


♦♦••AI********** 


XA01 

••••♦A2* ********* 

♦ ESTABLISH » 

» LEVEL OF ♦ 

>* DIAGNOSTIC ♦ 

» PRINT OUT • 


♦CONSTRUCT PHASE* 

• DIRECTORY TOR •<- 
* MESSAGE BLOCKS * 


XA1 . * . 

B2 *. 

. ♦ ANY * . 
YES .* ENTRIES *. 

». TO BE 

♦.PROCESSED.* 


***B3*********** 


XA4 V 

•••••Cl* ********* 

LOAD * 

MESSAGE * 

ADDRESS ♦- 

BLOCK * 


« , 


. * 


• ** 

**C2****+++ 


* 


♦ 

♦ 

SCAN 

* 

->♦ 

MESSAGE 


* 

CHAINS 

♦ 

* 

• ** 


♦ 

*** 


>»»*C3*»******* 

MAKE UP 
LIST OF 
BLOCKS 
NEEDED 


•♦♦•CM********** 

RELEASE * 

MESSAGE * 

ADDRESS * 

BLOCK • 


•♦♦••El* •*♦***•** 

* * 

* GET TO • 

* HEAD OF *- 

* CHAIN * 

* * 
•*****••♦*••*•**• 


.* ALL *. YES 

. ENTRIES .♦ 1 

•.PROCESSED.* 


LOAD 

NEXT 

BLOCK 


*• •£<!••••••*•••• 

PRINT OUT 
* APPROPRIATE ♦ 
SEVERITY 
HEADER * 


. 1 .. 

• • 

* G1 * 

• * 
***• 


.♦ SKELETON 
->*. IN CURRENT 
*. BLOCK . 


• •**• 112 *** ******* 

• MESSAGE * 

• NUMBER * 

* TO PRINT ♦- 

* BUFFER * 


END 

OF 

CHAIN 

"*. ,*' 


»••* 

YES * ♦ 

• >* DU » 


1 ***« 

♦ • 

->* G1 « 

* • 

*••• 

XA32 .*. 

H3 *. 

. * HAS *. 

.* IT GOT *. YES 

>♦. A STATEMENT .* 

*. NUMBER .* 

*. .* 

*. .* 


STATEMENT 
NUMBER 
TO PRINT 
BUFFER 


****J1********** 

• 

ACCESS * 

MESSAGE *- 

SKELETON » 


•••••j 2* ********* 

* * 

* SCAN * 

>* MESSAGE *- 

* SKELETON * 


•****J3* ••••••*• 

* BUILD 

* MESSAGE 
>* TEXT IN 

* PRINT 

* BUFFER 
••••*•*••*••*••• 


* PUT OUT 

> DIAGNOSTIC 

• MESSAGE 


.* WAS *. **♦* 

. • THIS *. YES * * 

. LAST ENTRY .♦ >» DU ♦ 

• . IN CHAIN .* ♦ • 
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Table TF. Phase TF Final Assembly Pass 1 


T T" 

|Main Processing! 
j Routine I 


| 


Statement or Operation Type 


Subroutines Used 


■H 


| Scans text 

| 1L0024 

| None 

.j. _ _ . 


1 

(Assigns offsets to labels 

j IL0019 

. j - 

(FINEQ1, NEXTSL 
j. 


h ~ 

(Increments location counter for 
j machine instructions 

j IL001 4 

1 

1 

| None 

1 

l 


1 — - - - 

(Determines code for instructions 
j which refer to labels 

| IL0020 

1 

.j. — — — — - - — — — 

j FINEQ1 

1 

. i 


(Initializes location counter at 
j start of procedure 

jlLOOlO 

1 

_ _ _j _ 

T 

| None 

1 

i _ . 


j Stores size of procedure and 
j resumes containing procedure 

jiLOOll 

1 

. _x 

| None 

1 

_ _ X _ 



Table TF1. Phase TF Routine/Subroutine Directory 


| Routine/Subroutine j Function | 

|FINEQ1 | Locates label number table entries. j 

jlLOOOO | Entry point from compiler control. j 

I I I 

JIL0003 | Entry point to scan from initialization routine. | 

i I I 

|IL0010 | Initializes location counter at start of procedure. | 

! I I 

jILOOll | Stores size of procedure and resumes containing procedure. | 

II I 

| IL0014 | Increments location counter for machine instructions. | 

I I I 

j IL0015 J Processes the start of prologues. | 

I ! I 

(IL0017 J Releases control. | 

I i I 

| IL0019 (Assigns offsets to labels. | 

I I I 

(IL0020 (Determines code for instructions which refer to labels. | 

I I I 

j 1L0022 (Processes end-of-block pseudo-code item. | 

I I I 

|IL0024 (Scans text. | 

| NEXTSL j Determines multiple statement label entries in dictionary. ! 
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Table TJ. Phase TJ Final Assembly Optimization 


j Statement or Operation Type 

| Main Processing! 
j Routine | 

_X _L 

Subroutines Used | 

r 

{Controls phase 

1 

j IL0000 
j. 

j OPTIMA 

4- 

. J 

{Maintains location counter for 
{machine instructions 

i IL0014 

1 

T 

| None 

1 

-j- 


j Assigns offsets to labels 

j IL0019 
| 

( COMRTN, 

j 

FINEQl, NEXTSL j 

{Determines code for instructions 
j which refer to labels 

j IL0020 

1 

| FINEQl 

1 

+ 

■ 

{Initialize location counter at 
j start of procedure 

jlLOOlO 

1 

| None 

1 

J. 

1 

j Stores size of procedure for 
j machine instructions 

i 

jlLOOll 

1 

-j. 

T 

| None 

^ 

r ■ 

{Reduces number of MVC instructions 

■ _ . 

1 IL0027 

i . .. . . 

.j. 

j OFFSET, 

. 4 . 

1 

OSMRTN { 

1 

r ~ - — 

(Determines offset from a given 
{dictionary reference 

T 

{ OFFSET 

1 

_x 

■ t 

( None 

1 

x 

4 


Table TJ1 . Phase TJ Routine/Subroutine Directory 


r t 

J Routine/Subroutine J Function 

{COMRTN {Determines whether further optimization is possible. 

j FINEQl {Locates label number table entries. 

I I 

jlLOOOO {Controls phase. 

| IL0003 {Entry point to scan loop from initialization. 

I I 

jlLOOlO | Initializes location counter at start of procedure. 

I I 

jlLOOll | Stores size of procedure and resumes containing procedure. 

I I 

| IL0012 (Processes machine instructions, etc. 

{IL0014 {Maintains location counter for machine instructions. 

I I 

|IL0019 {Assigns offsets to labels. 

| IL0020 (Determines code for instructions which refer to labels. 

|IL0024 {Gets pseudo-code item length and updates text pointer. 

I I 

j IL0027 (Elides MVC instructions. 

| IL1001 {Evaluates new ADCON needs. Sets location counter to zero. 

| IL1101 {Restores content of containing procedure. 

I I 

j NEXTSL (Looks for equivalent statement labels. 

|OFFSET (TK) {Determines offset from a given dictionary reference. 

| OPTIMA {Scans text. 

| OSMRTN j Scans ahead for literal offsets. 

I 



J 




Table TO. Phase TO Final Assembly External Symbol Dictionary 


1 

| Statement or Operation Type 

t - - t 

{Main Processing! 
j Routine j 

_i X 

Subroutines Used 


| Constructs first six standard ESD 
j entries 

| LG401 

1 

-j- 

j MOVE , 

1 

X 

NAME, 

ERROR 


| Constructs entries for external 
| procedure labels 

|LG001 

1 

X 

T 

| MOVE, 

1 

x . ... . 

ERROR 



r t 

| Constructs PR type entries for each|LG030 
| block and procedure j 

L x 

(move, 

1 

-j- 

NAME 



r 

| Constructs entries for external 
| variables and external entry names 

{ LG050 

1 

'|MOVE, 

J 

ERROR 



1 

| Constructs entries for controlled 
| variables and task names 

*| LG090 

1 

| ... 

i MOVE , 

1 

NAME, 

ERROR 


h 

| Constructs entries for Library 
j conversion modules 

| IL0200 

jlHEINC 

1 




Table TOl • Phase TO Routine/Subroutine Directory 


r T" 

I ROUTINE/SUBROUTINE I 


FUNCTION 




-H 


ERROR 

LG001 

LG030 

LG 050 

LGC55 

LG080 

LG085 

LG090 

LG093 

LG401 

MOVE 

NAME 

1HEINC (TQ) 


Truncates over-length external identifier, generates error message. 
Constructs entries for external procedure labels. 

Constructs PR type entries for each block and procedure. 

Constructs entries for external variables and external entry names. 
Processes ON-conditions and external variables. 

Processes external entry names. 

Processes FILE constants. 

Constructs entries for controlled variables and task names. 

Inserts name in ESD entry for CONTROLLED. 

Constructs first six standard ESD entries. 

Moves ESD entries to card buffers, and puts out buffer when full. 
Generates names for pseudo-registers. 

Constructs a string of Library module names. 
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Table TT. Phase TT Final Assembly Pass 2 

r t 

Main Processing 
Routine 


h 


Statement or Operation Type 


Subroutines Used 


-H 


Scans text 

j IL0002 

.1 

j None 




Generates text for RR instructions 

j IL0012 

| GENTXT 




Generates Text for RX non-branch 
instructions LM, STM, and SI Types 

j IL0013 

1 

j EOBRTN, 

1 

. j- _ 

GENTXT, 

OFFSET 


Generates text for shift 
instructions 

j IL0027 

1 

j GENTXT 

1 

i 




Generates Text for SS instructions 

j IL0014 

-j. 

— | - 

j EOBRTN, 

GENTXT, 

OFFSET 


Sets up trace information and 
numbers compiler labels 

j IL0019 

1 

-j- 

-j_ 

j GENTXT 

j 




Generates text for branch and load 
address instructions 

j IL0020 

1 

j FINEQ1 , 

GENTXT, 

OFFSET 


Initializes location counter at 
start of procedure 

j IL0010 

1 

j. 

| PUNCHT 

J 




_ T 

Resumes containing procedure at end|IL0011 
of procedure | 

_L 

| PUNCHT 

1 




Moves Text into card image 

Punches cards ensuring that RLD 
cards follow related TXT card 

| GENTXT 

| PUNCHT 

j 

j PUNCHT 

+ 

j CARDOU 

1 

4- 

— 



Generates text for compiler 

j INCLUD 

T 

j GENTXT 





! subroutine 
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Table TTl. Phase TT Routine/Subroutine Directory 
| Routine/Subroutine | Function 

Directs card image to load file or punch file. 


CARDOU 

E03RTN 

FINEQ1 

GENTXT 

IL0002 

1L0003 

IL0010 

IL0011 

IL0012 

IL0013 

IL0014 
IL0015 
IL0016 
IL0017 
IL0019 
IL0020 
IL0022 
XL0027 
OFFSET (TU) 


PUNCET 


Chains to next input text block. 

Locates label number table entries. 

Moves text into card image. 

Scans text. 

Entry point to scan from initialization routines. 

Initializes location counter at start of procedure. 

Resumes containing procedure at end of procedure. 

Generates text for RR instructions. 

Generates text for RX non- branch branch instructions, LM, STM, and 
SI type. 

Generates text for SS instructions. 

Processes the start of prologues. 

Processes the end of prologues. 

End- of -text routine. 

Sets up trace information and numbers compiler labels. 

Generates text for branch and load address instructions. 
End-of-block routine. 

Generates text for shift instructions. 

Determines offset and relocation pointer from given dictionary 
reference. 

Punches cards ensuring tnat RLD cards follow related TXT card. 
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Table UA. Phase UA Final Assembly Initial Values, Pass 1 

r T T 

| | Mam Processing! I 

j Statement or Operation Type j Routine j Subroutines Used | 

I- 4. + 4 

| Scans STATIC chain to beginning of jUAOOl |UA200, UA220, UA230 j 

j external section j | j 

h 4. + 4 

(Initializes scalar variables |UA200 | TXTMOV j 

j. 1 1 4 

j Initializes BCD for label |UA220 j RLDMOV, TXTMOV j 

I- + + 4 

(Initializes DED for temporary |UA230 j TXTMOV j 

j. 1 1 4 

(Initializes address constants. (UA010 (UA401, UA403, UA404, UA405, UA406 | 

|- + + 4 

(Initializes symbol table entries (UA080 j RLDMOV, TXTMOV j 

j. 4 + 4 

(Initializes address slots for (UA403 j RLDMOV, TXTMOV j 

| external variables j j | 

[initializes address slots for (UA401 (RLDMOV, TXTMOV | 

I functions and programmer-defined j j j 

j ON-condition names j | | 

[initializes address slots for label|uA404 |rldM0V, TXTMOV ] 

j constants j | j 

I- + + 4 

(Initializes address slots for entry (UA405 j RLDMOV, TXTMOV j 

I labels j j | 

(Initializes file attribute entries |UA406 | RLDMOV, TXTMOV | 

| and files II I 

^ 4. 4. 4 

(Initializes constants pool |UA014 | RLDMOV, TXTMOV j 

y 4 4- 4 

j Initializes dope vector skeletons |UA021 | TXTMOV | 

[initializes argxament lists (UA025 (RLDMOV, TXTMOV j 

L X L J 
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Table UA1. Phase UA Routine/Subroutine Directory 


— i 

I 

-H 


j Routine/Subroutine j 


Function 


r — — 

j OUTPUT (UB) 

T - 

jl 

| RLDMOV (UB) 

|1 

| TXTMOV (ua) 

|] 

| UAOOOO 


| UA001 


JUA0015 


| UA010 


| UA013 


JUA014 (UC) 


| UA021 


| UA0215 (UC) 


| UA025 


(UA033 


JUA080 (UC) 


| UA100 (UC) 


| UA100A 


| UA200 


| UA220 (UC) 


| UA225 (UC) 


| UA230 (UC) 


| UA401 


| UA403 


| UA404 


JUA405 


| UA406 


| UA407 


JUCINIT (UC) 


| UCUPDT (UC) 


IUC0080 (UC) 


| TIDY (UC) 

-L 


Moves card images to punch and/or load file. 

Moves RLD entries to card buffer. 

Moves TXT entries to card buffer 
Entry point from compiler control. 

Scans STATIC chain to start of external section, to initialize 
scalar variables. 

Return point for branches taken in first scan. 

Initializes address constants. 

Return point for branches taken in second scan. 

Initializes constants pool. 

Initializes dope vector skeletons. 

Produces text for dope vector skeleton. 

Initializes argument lists. 

Return point for branches taken in last scan. 

Initializes symbol table entries. 

Initializes one-word CSECT * IHEMAIN* . 

Exit from UA to compiler control and UD. 

Initializes scalar variables. 

Initializes BCD for label. 

Entry to label routines for label variable BCDs. 

Initializes DED and FED for temporary. 

Initializes address slots for functions and programmer- defined 
ON- condition names. 

Initializes address slots for external variables. 

Initializes address slots for label constants. 

Initializes address slots for entry labels. 

Initializes DECLARE control blocks for files and file attributes 
entries. 

Makes text for file attributes entry. 

Initializes array variables. 

Initializes arrays of varying strings. 

Initializes bit arrays. 

Completes packing of bit strings in structures or arrays. 
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Table UD. Phase UD Final Assembly Pseudo-Code Static DSA's 


Statement or Operation Type j 


|Main Processing! 
j Routine j 


Subroutines Used 


j Scans STATIC DSA chain |A1 

[scans STATIC DSA's AUTOMATIC chain |AUTO 


j DAT , LAB , STRUC 


j Initializes dope vectors for data j DATLAB 
| items and label variables j 

| (unstructured) j 


j TXTMOV ( UB ) , R IDMOV ( UB ) 


j Initializes dope vectors for 
I structures 


j STRUC 


TXTMOV ( UB ) , TLDMOV ( UB ) 


Table UDl . Phase UD Routine/Subroutine Directory 


j Routine/Subroutine j 

I- + . 


Function 


jAUTO 


I DATLAB 


j STRUC 


Scans STATIC DSA chain. 

Scans STATIC DSAs AUTOMATIC chain. 

Initializes dope vectors for data items and labels 
Initializes structure dope vectors. 


| UDOOO 

I 

jUDEND 


Entry point 
Releases control. 


i 

I 

H 
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Table UE. Phase UE Final Assembly Initial Values, Pass 2 


T T 

Main Processing 
Routine 


Statement or Operation Type 


Scans STATIC chain to beginning of 
external section 


UA001 


Subroutines Used 
UA200, UA220, UA230 


H 


Initializes scalar variables 


UA200 


TXTMOV (UB) 


Scans STATIC chain to initialize 
internal dope vectors 


•— 4 


UA003 


UA300, UA320, UA340, UA360, UA365 


Initializes dope vectors for 
internal strings 


UA300 


RLDMOV (UB), TXTMOV (UE) 


Initializes dope vectors for 
internal data arrays 


UA320 


RLDMOV (UB), TXTMOV (UE) 


H 


-f 

Initializes dope vectors for arrays 
of varying strings 


Initializes dope vectors for 
internal label arrays 


UA340 

UA360 


TXTMOV (UB), UCUPDT (UC) 


H 


RLDMOV (UB), TXTMOV (UB) 


-H 


Initializes dope vectors for 
internal structures 


UA365 


UA300, UA320, UA360 


Initializes arrays 


*UA030 


RLDMOV (UB), TXTMOV (UB) , 
UCINIT (UC) 


•H 


Initializes structures 


f 


y 

Initializes one word CSECT 
•IHEMAIN* 


UA040 

UA100 


■H 




TXTMOV (UB), UA200, UC0800 (UC) , 
TIDY (UC) 

OUTPUT, RLDMOV, TXTMOV (all in UB) 


-H 


Initializes CSECT for STATIC 
external variables 


UA1005 


OUTPUT (UB), UA030, UA200, UA300, 
UA320, UA360, UA365, UA401, UA406 


Makes up END card and terminates 
phase 

| Initializes array variables 


UA120 


OUTPUT (UB) 


4 4 ^ 

j UCINIT (UC) j TXTMOV (UB), UC0080 (UC), TIDY (UC) j 

A L J 
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Table UEl. Phase UE Routine/Subroutine Directory 


r T * 

| Routine /Subroutine | 


Function 


H 


j AREA 

(Initializes AREA variables. 

| 


| EVENT 

1 

(Initializes EVENT variables. 


| TASK 

1 

|Initilizes TASK variables. 


(UAOOO 

1 

(Entry point from UA and compiler control. 

1 


| UA001 

1 

| Scans STATIC chain to start of external section, to initialize 
(scalar variables. 

1 


| UA0015 

1 

(Return point for branches taken in first scan. 

1 


| UA003 

1 

( Scans STATIC chain to initialize all dope vectors for internal 
(variables. 

a 


| UA021 

1 

(Start of scan for arrays and structures. 

• 


| UA030 

1 

(Initializes arrays. 

i 


| UA031 

1 

(Produces RLD entry for label array virtual origin. 

i 


| UA 0 3 3 

1 

(Return point for branches taken in array scan. 

i 


| UA 0 3 4 

1 

(Produces RLD entry for data array virtual origin. 

i 


| UA040 

1 

(Initializes structures. 

i 


| UA100 (UC) 

1 

(Initializes IHEMAIN CSECT. 

■ 


| UA105 

1 

| Return point for branches taken in external scan. 

1 


| UA 120 

(Makes up END card and terminates phase. 


| U A 200 

1 

(Initializes scalar variables. 


| UA207 

1 

(Lists label variables. 


| UA300 

1 

(Initializes dope vectors for internal strings. 

1 


| DA 320 

1 

(Initializes dope vectors for internal data arrays. 


| UA340 

1 

(Initializes dope vectors for arrays of varying strings. 

1 


| UA360 

1 

(Initializes dope verrhors for internal label artays. 


| UA365 

1 

(Initializes dope vectors for internal structures. 

| 


| UA401 

1 

(Initializes address slots for functions and programmer-defined 
joN-condition names. 

I 


| UA406 

(Initializes DECLAPE control blocks for files and file attributes 
j entries 
j 


| UA1005 

1 

(Initializes CSECTs for STATIC external variables. 

j 
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Table UF. Phase DF Final Assembly Object Listing 


I 

| Statement or Operation Type 
j Scans Text 


h 

| Lists RR instructions 
| Lists RX non-branch instructions 


Main Processing 
Routine 

IL0002 


Subroutines Used j 

None S 


IL0012 

IL0013 


+ 


PRINIT, RRRTN 


■H 


f 




| Lists SS instructions 

I- 

| Lists shift instructions 
| Lists LM and STM 

h 


IL0014 


BXRTN, PRINIT, PRNTOU, PRNTVF, 

SECOND | 

EOBRTN, PRINIT, PRNTOU, SSRTN I 




IL0026 

IL0027 

IL0028 


PRINIT, 

PRINIT, 


PRNTOU, PRNTVF 
PRNTOU, PRNTVF, SECOND 


* 


— (. 

CHARVF, 
SECOND, 

-+ 

IL0013, 
RRRTN 

-+ 

NAMEVF, 
PRNTLC , 

~+ 

NAMEVF, 


-H 


+ 


| Lists SI instructions 

I 

I- 

| Lists branch and load address 
| instructions 

I- 

| Lists labels 

1 _______ __ 

j Lists procedure names 

I- 

| Lists ends of procedures 

j Scans ahead for literal offsets; 
j inserts second instruction byte 
| into print image 

j Generates listing of text for base 
| offset pair 

j Names generated label number 

(Inserts location counter value, and 
j hexadecimal and mnemonic operation 
j codes in print line 

j Moves variable length item into 
j variable field part of print line 

(Lists statement numbers 

(Determines name and offset from 
(dictionary reference 

(Generate listing of compiler 
j subroutine 


IL0020 

IL0019 

IL0010 




+ 


PRINIT, PRNTOU, PRNTVF 
SSRTN | 

4 

NAMEIT, NAMEQU, PRINIT, j 

I 

( 

NEXTEL, NEXTSL, j 

PRNTOU, PRNTVF, STATMN 


+ 

IL0011 

SECOND 

^SSRTN, BXRTN 
+ 


NEXTEL, PRNTOU, STATMN 
NAMEVF, NEXTEL, PRNTOU 


-H 

I 

■H 

I 

H 


EOBRTN 


NAMEQU 

PRINIT 




+ 

ABSOFF, ADDEND, NAMEIT, NAMEQU, j 

PRNTVF j 

DECINT, FINEQ1 | 

^PRNTLC I 


^PRNTVF 
+ 


+ -- 

PRNTOU 


4 


STATMN 

NAMEIT 


+ 


*IL0017 


^STATNO 1 

+ H 

DECINT, HEXINT | 

PRNTLC , PRNTVF, PRNTOU | 
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Table UF1. Phase UF Routine/Subroutine Directory 

r t 1 

j Routine /Subroutine | Function | 


r — - 


~ T ~ “ ” - 


jABSOFF 

l 


| Appends literal offsets to operands in variable part of print line. 
I 


i 

| ADDEND 

i 


1 

| Appends signed literal offsets to operands. 

1 


l 

J BXRTN/SSRTN 

1 

| Generate listing of text for base offset pair. 


1 

j CHARVF 

(UG) 

1 

| Places one character in variable field of print line image. 

i 


IDECINT 

(UG) 

1 

| Converts binary to externally coded decimal. 

i 


| EOBRTN 


1 

| Chains to next input block. 

1 


| FINEQl 


1 

| Locates label number table entries. 


| HEXINT 

(UG) 

1 

| Converts binary to externally coded hexadecimal. 

1 


| 1L0000 


1 

| Entry point from compiler control. 

1 


| IL0002 


1 

| Scans text. 


| IL0003 


1 

| Entry to scan from initialization routines. 

| 


| IL0010 

(UG) 

1 

| Lists procedure names, 
j 


| IL0011 

(UG) 

1 

| Lists ends of procedures. 

1 


1 IL0012 


1 

J Lists RR instructions. 


| IL0013 


1 

| Lists RX non-branch instructions. 

1 


| IL0014 


| Lists SS instructions. 


| IL0015 


i 

| Processes the start of prologues. 


| IL0016 


| Processes the end of prologues. 


j IL0017 

(UI) 

JEnd-of-text routine, and compiler subroutine listing. 


| IL0018 


j Processes compiler generated label numbers. 

1 


| 1L0019 

(UG) 

1 

| Lists labels. 


1 IL0020 


| Lists branch and load address instructions. 


| IL0026 


1 

| Lists shift instructions. 


| IL0027 


1 

J Lists LM and STM. 


j IL0028 


1 

| Lists SI instructions. 


| IL0032 


| Processes SS decimal instructions. 


1 IL1003 

(UG) 

| Prints "+PROCEDURE" followed by entry names and statement number. 


| IL2005 


j Identifies operands. 


| NAMEIT 


| Determines name and offset from dictionary entry. 


| NAMEQU 


| Names generated label number, 
j 


| NAMEVF 

(UG) 

| Places a variable name in the print line. 


| NEXTEL 

L 

(UG) 

j Scans dictionary for multiple entry labels. 

j 
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Table UF1 . Phase UF Routine/Subroutine Directory (cont'd) 

Function 


| Routine/Subroutine | 


r 

j NEXTSL 

<UG) 

— r 

1 

| NM0003 

<UH) 

1 

| 

i 

| PRINIT 

(UG) 

1 

1 

| PRNTLC 

(UG) 

1 

| 

1 

| PRNTOU 

(UG) 

1 

I 

| PRNTVF 

(UG) 

1 

1 

| RRRTN 


1 

| SECOND 


1 

1 

1 

| STATMN 

(UG) 

1 

1 

| STATNO 

i 

(UG) 

1 

X 


Scans dictionary for multiple statement labels. 

Common return point in naming routine. 

Prints location counter value, hexadecimal, and mnemonic op codes. 
Converts location counter to hexadecimal; places it in print image. 
Prints a line. 

Moves variable length item into variable field part of print line. 
Generates RR format listing of text. 

Scans ahead for literal offsets; inserts second instruction byte 
into print image. 


Lists statement numbers. 

Converts statement number to decimal. 
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Table XA. Phase XA Error Message Editor 


Statement or Operation Type 


I 

f- 

| Determines whether error messages |XA 
jare to be printed i 

j Scans error message text skeletons |XA8 
jand prints them out j 


(Main Processing! 
1 Routine j 


Subroutines Used 


None 


jXA50, XA70, XA90, XA110, ZUPL 


H 


Table XA1. Phase XA Routine/Subroutine directory 


| Routine/Subroutine | Function | 

j XA (Determines whether error messages are to be printed. 

I I 

jXAO | Sets severity code. 

I I 

|XA01 \ Establishes which message types to suppress. 

I I 

jXAl (Counts number of error chains to be processed. 

I I 

j XA2 | Puts out messages if there are no diagnostics. 

I I 

j XA4 (Prints out "COMPILER DIAGNOSTIC MESSAGES*. 

I I 

|XA7 | First scan of message chains. 

I I 

(XA8 | Scans error message text skeletons and prints them. 

|XA9 (XB) (Scans to head of next non-empty chain. 

I ( 

| XA12A | Selects and prints header for messages of given severity. 

I ( 

j XA30 (XB) | Gets next entry in message chain. 

| XA32 (XB) (Builds up first part of message in buffer. 

I I 

|XA35 (XB) (Accesses message skeleton. 

| XA40 (XB) (Puts out completed message. 

| XA50 (XB) j Moves message text to print buffer. 

|XA70 (XB) (Converts binary statement number to character representation, and 

| j moves it to print buffer. 

|XA90 (XB) (Converts binary numeric value to character representation and moves 

j (it to print buffer. 

( XA110 (XB) |Moves identifier from dictionary entry to the print area. 

| ZUPL (Prints a line on SYSPRINT data set. 
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APPENDIX A: GUIDE TO PHASES AND MODULES 


This 

appendix relates the logical 


JZ 

Builds second half 

phases , 

physical 

phases , and modul es 



phase directory 

contained within 

the physical phases. The 




compiler 

name is 

IEMAA. 

Compile-? 

■time Processor Loqical Phase 




AS 

Resident phase for 

PHYSICAL 




compile- time processor 

PHASE 

MODULES 

DESCRIPTION 


AV 

Initialization phase 

Compiler Control 




for compile-time 






processor 


AA 

Controls running of 
compiler 

BC 

BC,BE,BF 

Initial scan and 
translation phase for 


AB 

Performs detailed 



compile-time processor 



initialization 

BG 

BG, BI,BJ 

Final scan and 


AC 

Writes records on 



replacement phase for 



intermediate file 

SYSUT3 



compile-time processor 




BM 

BM, BN 

Error message printout 


AD 

Performs inter-phase 



phase 



dumping as specified in 
the DUMP option 


BO, BV 

Contain the diagnostic 
messages 


AE 

End of read- in phase 

BW 


Cleanup phase for 


AF 

Controls system 
generation compiler 



compile-time processor 



options 

Read-In Loaical Phase 


AG 

Closes SYSUT3 for 


CA 

Read-In phase common 



output, reopens for 



routines 



input 


CC 

Read-In phase common 


AH 

Format annotated 
dictionary dump 



routines 





CE 

Keyword tables 


AI,AJ 

Format annotated text 
dump 

Cl 

CG,CI 

Read-In first pass 


AK 

Closing phase of 
compiler 


CK 

Keyword tables 




CL 

CL, CM 

Read-In second pass 


AL 

Controls extended 
dictionary compilation 


CN 

Keyword tables 


AM 

Phase marking 

CO 

CO, CP 

Read-In third pass 


AN 

Controls normal 


CR 

Keyword tables 



dictionary compilation 

CS 

CS,CT 

Read- In fourth pass 


AT 

Carries out extra 
debugging during 
compiler runs 

CV 

CV,CW 

Read-In fifth pass 




Dictionary Locrical 

Phase 


BX 

48-character set 
preprocessor 

ED 

ED 

Initialization , 
subroutine package for 


FI 

Checks whether Syntax 
Check should terminate 



Declare Pass 2 



compilation 

EG 

EF,EG 

Initialization 
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PHYSICAL 


PHASE 

MODULES 

DESCRIPTION 

El 

EH,EI,EJ 

First pass over DECLARE 
statements 

EL 

EKf ELf EM 

Second pass over 

DECLARE statements 

EP 

EP 

Constructs dictionary 
entries for PROCEDURE, 
ENTRY and CALL 
statements 

EW 

EV,EW 

Constructs dictionary 
entries for LIKE 
attributes 

EY 

EX,EY,EZ 

Constructs dictionary 
entries for ALLOCATE 
and for explicitly 
qualified based 
variables. 

FA 

FA,FB 

Checks context of 
source text 

FE 

FE,FF 

Changes BCD to 
dictionary references 

FI 

FI 

Checks validity of 
dictionary references 

FK 

FK 

Rearranges attributes 

FO 

FO, FP 

Constructs dictionary 
entries for 
ON-conditions 

FQ 

FQ 

Checks validity of 
PICTURE chain for PL/I 
functions and the 
TRANSLATE and VERIFY 
functions 

FT 

FT,FU 

Dictionary 
hous e- keeping 

FV 

FV,FW 

Merges second file 
statements into text 

FX 

FX,FY,FZ 

Processes identifiers 


for cross reference and 
attribute listing 


Pretranslator Logical Phase 


GA 

GA 

Constructs DECLARE and 
OPEN control blocks 

GB 

GB,GC 

Modifies I/O statements 

GK 

GK 

Checks parameter 
matching 


GO 

GO 

Preprocessor for second 
check on parameters 

GP 

GP,GQ,GR 

Second check on 
parameters 

GU 

GU,GV 

Processes CHECK 
condition statements 

HF 

HF, HG 

Processes structure 
assignments 

HK 

HK,HL 

Processes array 
assignments 

HP 

HP 

Processes items defined 
using iSUBs 

Translator Logical 

Phase 

IA 

IA,IB,IC 

Stacks operators and 
operands 

IG 

IG 

Processes array and 
structure arguments and 
built-in functions 

IK 

IK 

First part of 
preprocessor for 
generic functions 

IL 

IL 

Second part of 
preprocessor for 
generic functions 

IM 

IM, IN, IP, 
IQ 

Processes generic 
functions 

IT 


Processes function 
triples 

IX 

IX 

POINTER and AREA 
checking 

JD 

JD 

Evaluates constant 
expressions 

Aggregates Logical 

Phase 

JI 

JI, JJ 

Structure 

pre-preprocessor 

JI 

JI, JK, JL 

Structure preprocessor 

JK 

JK,JL,JM 

Structure processor 

JP 

JP 

Checks DEFINED chains 

Optimization Logical Phase 

KA 

KA, KB 

Table handling and 
initialization 

KC 

KC f KCl 

DO temporaries 
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PHYSICAL 



MK 

MK 

Constructs pseudo-code 

PHASE 

MODULES 

DESCRIPTION 



for in-line functions 

KE 

KE,KEl 

DO MAP build 

ML 

ML 

Processes generic entry 

KG 

KG,KGl 

EX) examine 



names 

KJ 

KJ 

SUBS TABLE build 

MM 

MM, MN , MO 

Processes CALL and 

KN 

KN 

Initialization 



function procedure 
invocations 

KO 

KO,KP,KQ 

Subscript optimization 

1 and 2 

MP 

MP 

Reorders BUY and SELL 

KT 

KT 

SCAN utility 



statements 

KU 

KU,KV 

Merge patches and loop 

MS 

MS, MT 

Constructs pseudo-code 



control 



for subscripts 

Pseudo-Code Logical 

Phase 

NA 

NA 

Generates pseudo-code 






for branches, RETURN 

LB 

LB, LC 

Generates triples to 



triples, etc. 



initialize AUTOMATIC 
and CONTROLLED scalar 

NG 

NG 

Generates Library 



variables 



calling sequences for 
DELAY and DISPLAY 

LD 

LD 

Constructs dictionary 



statements 



entries for initialized 
STATIC scalar variables 

NJ 

NJ, NK 

Generates Library 



and arrays 



calling sequences for 
executable 

LG 

LG,LH 

Expands DO loops 



RECORD-ori ented 
input/ output statements 

LR 

LR 

Fixed decimal 
expression optimization 

NM 

NM,NN 

Generates Library 



and initialization for 



calling sequences for 



phase LS 



executable 

STREAM-ori ented 

LS 

LS,LT,LU 

Converts expression 
triples to pseudo- code 



input/output statements 




NT 

NT 

Pre- processor for NU 

LV 

LV 

Provides string 
handling facilities 

NU 

NU, NV 

Generates Library 
calling sequences for 

LW 

LW 

Initialization for 
phase LX 



data/format lists 




OB 

OB,OC 

Processes compiler 

LX 

LX,LY 

Converts string triples 



functions and 



to pseudo- code 



pseudo- variables 

MA 

MA 

Constructs pseudo- code 

OD 


Pseudo-code assignment 



for functions 

OE 

OD,OE, OF 

Constructs Pseudo-code 

MB 

MB,MC 

Constructs p3eudo-code 



for assignments 



for pseudo- variables 

OG 

OG , OH , OL, 

Generates library 

MD 

MD 

Scans for ADDR and 

STRING functions and 


01 

calling sequences 



generates code for each 

OM 

0M,0N,00 

Generates pseudo- code 
for data type 

ME 

ME 

Constructs pseudo- code 



conversions in-line 



for in-line functions 

OP 

OP, OQ 

Generates pseudo- code 

MG 

MG, MH 

Constructs pseudo- code 



for further in-line 



for in-line functions 



conversions 

MI 

MI,MJ 

Constructs pseudo- code 

OS 

os , or , ou 

Converts constants to 



for in-line functions 



required internal form 
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PHYSICAL 


PHASE 

MODULES 

DESCRIPTION 

Storaqe 

Allocation 

Loqical Phase 

PA 

PA 

Puts eligible DSA's 
into STATIC 

PD 

PD 

First STATIC storage 
allocation phase 

PH 

PH 

Second STATIC storage 
allocation phase 

PL 

PL f PM 

Constructs symbol 
tables and DEDs 

PP 

PP#PO 

Sorts AUTOMATIC chain 

PT 

PT,PU,PV 

Allocates AUTOMATIC 
storage 

QF 

QF# QG#QH 

Constructs prologues 

QJ 

QJ,QK,QL 

Allocates DYNAMIC 
storage 

QU 

QU 

Aligns misaligned 
operands and processes 
halfword binary 
operands 

QX 

QX 

Lists lengths of 
aggregates 

Reqister 

Allocation Loqical Phase 

RA 

RA # RB#RC 

Processes addressing 
mechanisms 

RD 

RD 

Flags branches for 
optimization 

RF 

RF,RG,RH 

Allocates physical 


registers 


Final Assembly Logical Phase 


TF 

TF 

Assembly first pass 

TJ 

TJ.TK 

Optimization 

TO 

TO # TP # TQ 

Produces ESD cards 

TT 

TT.TU 

Assembly second pass 

UA 

UA# UB# UC 

Final assembly initial 
values# first pass 

UD 

UD,UB,UC 

Generates RLD and TXT 
cards to set up dope 
vectors for STATIC DSAs 

UE 

UE,UB,UC 

Final assembly initial 
values# second pass 

UF 

UF,UG#UH 

Produces listings 

UI 

UI#UG,UH 

Completes final 
assembly listings 

Error 

Editor 


XA 

XA 

Determines whether 
there are diagnostic 
messages to be printed 


XA#XB 

Constructs the third 
phase list 


XA# XC 

Controls the printing 
of messages 


XF 

Message address blocks 


XG.YY 

Contain the diagnostic 


messages 
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$ REPRESENTS COMPILER DEBUGGING ROUTINES , AD, AH, A I , A J OR AT, 
WHICH HAY RE IN PERMANENT RESIDENCE IF REQUESTED 



•Figure 7. PL/ I Phase-in-Storage Map 


In this phase-in-storage map, modules on 
the same horizontal line may be in storage 
together. Modules on the same vertical 
line earn never be in storage together. 


This map represents the 'worst* case, and 
does not always reflect the order of 
loading. 
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APPENDIX B: RESIDENT TABLES 


There are three resident tables: the 
dictionary, the keyword tables, and the 
phase directory. The dictionary is 
resident through part of the compilation; 
the formats of the dictionary entries are 
fully described in Appendix C. The keyword 
tables are resident during the read-in 
logical phase, and the phase directory 
throughout the compilation. 


ORGANIZATION OF KEYWORD TABLES 


The read- in phase is divided into five 
passes containing the modules shown in 
Figure 8. 

Modules CA and CC contain routines which 
are common to all five passes. Successive 
blocks of routines overlay the areas used 
in the first pass by modules CE, CG, and 
Cl. The keyword tables are held in 
separate modules (CE, CK, CN, and CR) which 
must each be less than 1,024 bytes (IK) 


long. In this way it is possible to hold 
in storage only those keywords which are 
required for any one pass. The keyword 
tables are constructed in the following 
manner. 

For ease of searching and modifying a 
keyword table, it is organized into two 
levels and by keyword length, as shown in 
Figure 9. 

The KEYWD routine is called by one of 
the statement scanning routines, and is 
supplied with a parameter which enables it 
to decide which set of keywords to look at 
(e.g., statement identifier, ON condition, 
miscellaneous) . It does this by using the 
parameter to extract the required relative 
address (R(A),etc.) from the first level 
directory. The second level directory 
provides the KEYWD routine with the means 
of reaching a table containing keywords of 
correct length; the KEYWD routine calls the 
KEYID routine, which scans the next 
significant item in the source text to 
obtain the length used in this look-up. 


I I 

I CA | 

I I 


CC 


> Common Routines 




i 

1 

i 


T 

1 

1 



1 

I 




— 1 

1 

r — 1 

1 

r J 

i 

1 

l 

" 1 

| CE 

1 

1 

1 CK | 

1 

j CN 

1 

1 

1 

CR | 

1 

j 

■ 

i . . i 

1 



i 

L_ 




1 

1 

1 


1 

1 

1 



1 

1 

i 



1 

T 

1 

1 

1 

r i 

i I 

1 

I 

l — 

j 

i 

i 

l 

I 

r“ 

1 

' 1 " " i 

j 

1 

| CG 

1 

{ 

1 

1 

1 

| 

1 

1 

1 

1 

1 1 

1 CL | 

1 1 

L _ J 

1 

1 

1 

1 

| CO 

1 

I 

1 

1 

j 

1 

1 

1 

I 

1 

1 

1 

L_ 

CS 1 

1 



1 

1 

i 


1 

1 

1 



1 

1 

i 



r 

1 

1 ci 

1 

1 

1 

1 

1 

i i 

1 CM | 

i i 

1 

1 

1 

1 

1 

1 

j CP 

1 

~ i 

1 

1 

i 

1 

1 

1 

1 

r 

1 

1 

i 

1 

CT | 

j 

1 

1 

— rJ 

1 

1 1 

i j 

1 

1 

1 

1 

1 

_ j 

1 

1 

1 

L- 

1 

Pass 

1 

1 

1 

1 

Pass 2 

1 

1 

1 

Pass 

3 

1 

1 

1 


Pass 4 

Figure 

8. 

Organization of 

Read- In Phase 






Pass 5 
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Format of Third Level Tables 



R(A) 


f* 


lH R(B) 

y 1 

j R(C) 

»• "I 


1 . 


B«.> 


»■ * 

I I 

I ^ 


h 
I 

I- 

I 

* 


^ 

I 

^ 


First Level 
Directory 


ct> 


r 

L _ 

_ j 

r 

L _ 

1 

_ j 

r 

L _ 

1 

_ j 

r 

1 


Second 

Level 

Direc- 


Figure 9. Organization of Keyword Table 


The third level tables have a prefix byte 
containing the number of entries in this 
particular table followed by keyword 
entries. These consist of the keyword in 
internal code plus the replacement 
character (keywords recognised as such are 
replaced by a single code byte) . 


STLra DC FLl'x* where x is number of 
keywords in this table 

DC X* 112315* keyword in internal 
code 

DC X'55* replacement in internal 
code 

DC X* 393839* 

DC X*5A* 


Format of First Level Directory 


FSTLVL DC AL2 ( STAT1D - FSTLVL) 
DC AL2 (ONID - FSTLVL) 


Format of Second Level Directory 


The second level tables contain relative 
addresses, which enable the KEYWD routine 
to reference a third level table containing 
keywords of the correct length. If one of 
these entries should contain zero, then 
KEYWD will interpret this as meaning that 
no keywords of this length exist in this 
table. 


STATID DC FL2*ra* where m is smallest 
length in table 

DC FL2'n* where n is largest 
length in table 

DC AL2 (STLm- STATID) 

DC AL2 ( STLn-STATID) where the 

symbols beginning STL are 
the symbolic addresses of 
the corresponding keyword 
tables 


Some keywords are not represented by one 
word (e.g. , GO TO, BY NAME) and clearly, 
the mechanism must be modified to cope with 
the second word. This modification is 
achieved by placing a 1-bit into the first 
bit of the first level by rising the OR 
logical operation. The presence or absence 
of this bit is tested by the KEYWD routine 
before the suspected keyword is compared. 

If the bit is absent, the pass through the 
routine is quick, as there is no 
possibility of an extra level search. If 
the bit is present, the keyword must be 
compared after the additional bit has been 
removed by the AND logical operation. If 
the comparison is equal, the two bytes 
following the replacement character are 
used as a relative address to reach the 
next level table. 


Format of Entry Requiring Additional 
Comparisons 


DC X* 9726 * GO ♦ X*1000* 

DC X* 40 * 

DC AL2 (N XTLVL-*) Relative address 
of next level table 

The format of these extra level tables 
is similar to that for the third level. In 
this way, it is possible for national 
language keywords to replace single words 
by two or more words, if so desired. 
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PHASE DIRECTORY 


The format of a phase directory entry is 
as follows: 


Because of the number of phases in the 
compiler, the phase directory is split into 
halves. The first half is constructed 
during the initialization of the compiler; 
also a list of names of the phases in the 
second half is kept in Phase AA. This list 
is used to pass status indications (i.e., 
whether phases are wanted or not wanted) 
from the first half to the second half. 
Phase JZ uses the list to construct a new 
directory for the second half. 

The phase directory is constructed by 
use of the BLDL macro and a build list. 

The format of the build list is fully 
described in the publication IBM System/360 
Operating System. Supervisor and Data 
Management Services . 

Each entry in the build list is 30 bytes 
long. On returning from the BLDL macro, 
two bytes of the name field and ten other 
bytes of each satisfied entry in the build 
list are used to construct a 12- byte phase 
directory entry in the compiler control 
routines. The build list is destroyed 
after the initialization process is 
complete. 


I Bvte Number | Description ~| 


0-1 


3-4 


5-7 


8-9 

10 - 11 
l 


Phase name 


Status byte 


Concatenation number and 
library identification 

TTR of first text record; 
where TT is the relative 
track number, and R is the 
block number on that track. 
After the phase is loaded, 
these bytes contain the 
absolute address of the 
begining of the phase. 

Total amount of storage 
required 

Length of first text record 

j 
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APPENDIX C: INTERNAL FORMATS OF DICTIONARY ENTRIES 


This appendix describes the formats of 
dictionary entries during the compilation 
of a source program. The appendix is 
organized in the following manner: 


First Half Byte 

Bit Bit 

Position Value Meaning 


1. Dictionary Entry Code Bytes 


0 


0 entry has BCD 

1 entry has no BCD 


2. Dictionary Entries for ENTRY Points 


1 * 


0 entry is to be chained 

1 entry not to be chained 


3. Code Bytes for ENTRY Dictionary 
Entries 


4. Dictionary Entries for DATA, LABEL, 
and STRUCTURE Items 


5. Code Bytes for DATA, LABEL, and 
STRUCTURE Dictionary Entries 


2 


0 not a member of structure 

1 member of structure 


3 


0 not dimensioned 

1 dimensioned 


♦This bit only applies to Phase FT which 
constructs the storage class chains by a 
sequential scan of the dictionary; later in 
the compiler, items with this bit on are 
added to the storage class chains. 


6. Format of Variable Information 

7. Other Dictionary Entries 

8. Dimension table 

9. Dictionary Entries for Initial Values 


Second Half Byte 

In the second half byte, the following 
codes have the meanings shown, unless the 
first half byte is X'C*: 


X* 7 ' 

means 

label variable 

X'C* 

means 

task identifier 

X'D* 

means 

event variable 

X’E* 

means 

structure 

X* F* 

means 

data variable 


1. DICTIONARY ENTRY CODE BYTES 


The dictionary is used to communicate a 
complete description of every element of 
the source program, the compiled object 
program, and the compiler diagnostic 
messages between phases of the compiler; 
the text describes the operations to be 
carried out on the elements. 


Each type of element has a 
characteristic dictionary entry, which is 
identified by a code occupying the first 
byte of the entry. In general, each type 
of element has a different code byte, but 
in order to permit rapid identification of 
dictionary entries, the code bytes have 
been allocated on the following basis: 


The second and third bytes of every 
dictionary entry contain the length, in 
bytes, of the entry. If the entry has BCD 
(i.e. , the first bit of the entry is zero), 
this length count does not include the BCD; 
instead, the BCD, which follows the main 
body of the entry, is preceded by a single 
byte containing one less than the number of 
characters of BCD. 

Using this general scheme, the code 
bytes allocated for dictionary entries 
appear in the following table. Code bytes 
in the table which have no corresponding 
description are not allocated. 

X*00* Statement label constant 

01 Procedure or entry label 

02 GENERIC entry label 

03 External entry label (entry type 4) 

04 Built-in function, e.g., DATE 

05 Temporary variable and controlled 
allocation workspace 

06 Built-in GENERIC label, e.g., SIN 

07 Label variable 

08 File constant 

09 
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OA 

OB 

OC Task identifier 
OD Event variable 
OE 

OF Data variables (not dimensioned or a 
structure member) 

10 

11 

12 

13 

14 

15 

16 

17 Dimensioned label variable 

18 

19 
1A 
IB 

1C Dimensioned task identifier 
ID Dimensioned event variable 
IE 

IF Dimensioned data variable 

20 
21 
22 

23 

24 

25 

26 

27 Label variable in structure 

28 

29 
2A 
2B 

2C Task identifier in structure 
2D Event variable in structure 
2E Structure item 
2F Data variable in structure 

30 

31 

32 

33 

34 

35 

36 

37 Dimensioned and structured label 
variable 

38 

39 
3A 
3B 

3C Dimensioned task identifier in 
structure 

3D Dimensioned event variable in 
structure 

3E Dimensioned structure item 
3F Dimensioned and structured data 
variable 

40 Formal parameter type 1 

41 

42 

43 

44 


45 

46 

47 

48 

49 
4A 
4B 
4C 

4D ON CONDITION entry 

4E 

4F 

80 ENTRY type 1 — from a PROCEDURE 
statement 

81 BEGIN statement entries — entry 
type 1 

82 ENTRY statement — entry type 1 

83 Entry type 5 

84 Entry type 3 

85 Entry type 2 

86 Entry type 6 

87 Label variable formal parameter or 
temporary 

88 Constant 

89 File formal parameter or file 
temporary 

8A 

8B 

8C Task identifier formal parameter 
8D Event variable formal parameter 
8E 

8F Data variable formal parameter or 
temporary 

90 Invocation count dictionary entry 

91 

92 

93 

94 

95 

96 

97 Dimensioned variable formal parameter 
or temporary 

98 File attribute entry 

99 
9A 
9B 

9C Dimensioned task identifier formal 
parameter 

9D Dimensioned event variable formal 
parameter 
9E 

9F Dimensioned data variable formal 
parameter or dimensioned temporary 

A0 

A1 

A2 

A3 

A4 

A5 

A6 

A7 Structured label variable temporary 

A8 

A9 

AA 

AB 

AC Structured task identifier temporary 
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AD Structured event variable temporary 5 

AE Temporary or formal parameter 

structure 6-7 

AF Structured data variable temporary 

BO 

B1 8-9 

B2 

B3 

B4 

B5 

B6 


B7 Dimensioned and structured label 10-11 

variable temporary 
B8 
B9 
BA 

BB 12-13 

BC Dimensioned and structured task 

identifier temporary t 

BD Dimensioned and struct ured event 14-15 j 

variable temporary 16-17 > 

BE Dimensioned structure formal 18-19 | 

parameter or temporary J 

BF Dimensioned and structured data 

variable temporary 20-21 


CO String dope vector for temporary 
Cl DED2 entry 

C2 Internal library function, e.g., 
conversion routines 
C3 Compiler label 
C4 Prefix ON list item 
C5 Parameter lists 

C6 Dope vector skeletons 22-23 

C7 Symbol table entry or DED entry 
C8 Error message, table entry, workspace 

requirement, STATIC DSA, etc. 24-25 

C9 Record dope vector (RDV) entry 
CA Workspace requirement entry 
CB Select a member from a generic family 
CC AUTOMATIC chain delimiter or Dope 26-28 

Vector Descriptor (DVD) entry 
CD ON condition entry 
CE Label BCD entry 

CF End of information in dictionary 
block 


2. DICTIONARY ENTRIES FOR ENTRY POINTS 


29-31 

Entry type 1 for PROCEDURE. BEGIN, and 
ENTRY statements 


The format of an entry for a PROCEDURE 
statement is as follows: 

Byte Number Description 


1 Code byte X*80' 

2-3 Length 

4 Level 


32-34 


35-37 


38-40 


Count 

Dictionary reference to the 
entry type 1 of the 
containing block 

Dictionary reference of the 
dictionary entry for the 
first label that was 
attached to the PROCEDURE 
statement 

Dictionary reference to the 
entry type 1 of the next 
PROCEDURE or BEGIN statement 
in the source program 

The start of the chain of 
all AUTOMATIC variables 

Dictionary references to 
three dictionary entries 
indicating storage require- 
ments for workspace 

Dictionary reference of 
CHECK list set by phase FO. 

Phase QU re-uses this slot 
and sets it to the offset 
from register 9, at which 
the register allocator 
workspace is to start. 

Dictionary reference of 
NOCHECK list 

Dictionary reference of the 
first symbol table entry for 
this block 

Size of the DSA for this 
block, set in storage 
allocator phase 

Note: Phase MA moves, into 
bytes 27 and 28, the 
dictionary reference of a 
temporary describing a table 
to be built at execution 
time for the TRANSLATE or 
VERIFY function. 

Offset of the eight words in 
the DSA used for addressing 
the DSA 

Offset of the storage used 
for the parameter list 
necessary in an ALLOCATE- 
FREE statement 

Offset of the two -byte 
switch which is set on entry 
to a procedure and tested at 
a RETURN (expression) 

Offset of the four-byte slot 
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41-42 


43 

44-57 


which will contain the 
address of the first 
approximation of the target 
field (the address of the 
implied parameter) 

Dictionary reference of the 
entry type 1 of the first 
ENTRY statement of the 
procedure. The entry type 1 
for PROCEDURE and ENTRY 
statements of any one proce- 
dure form a circular chain. 
If there are no ENTRY state- 
ments in a procedure this 
slot will contain the dic- 
tionary reference of the 
PROCEDURE'S entry type 1, 
i.e., of the entry in which 
the slot occurs 


statement number, or to SL for a statement 
label. Bytes 36-56 contain the same as 
bytes 44-64 in a PROCEDURE entry type 1. 

The format for the entry type 1 derived 
from an ENTRY statement is as follows: 


Byte Number Description 


1 Code byte X'82* 

2-3 Length 

4 Level 


5 


Count 


6-7 Dictionary reference of the 

next member in the circular 
PROCEDURE-ENTRY chain 


OPTIONS code byte 

Eight 2- byte dictionary 
references to dictionary 
entries for prefix options. 
Only those prefix options 
which are changed within the 
procedure have a dictionary 
reference. The remainder 
are zero. The order of the 
options in this list is the 
same as in the options byte. 
(See "Options Code Byte" in 
Section 3 below) 


8-9 Dictionary reference of the 

dictionary entry for the 
first label on the original 
ENTRY statement 

10-12 The offset of the apparent 

entry point 

13 2*n where n is the number of 
parameters 

14 onwards n dictionary references to 

the formal parameter type 1 
entries 


60 


Options change byte. This 
byte contains a one bit for 
each prefix option which is 
changed within the proce- 
dure. Its format is identi- 
cal with the normal options 
byte 


The labels on a PROCEDURE or ENTRY 
statement will be placed in the dictionary 
according to the following format: 

Byte Number Description 

1 Code byte X'01' 


61-63 Offset of workspace used in 

BUY statement 

64 Optimization byte 

65 2*n where n is the number of 
parameters at this entry 
point 

66 onwards N dictionary references of 

formal parameter type 1 
entries 

The format of an entry for a BEGIN 
statement is similar to the above for the 
first 34 bytes. The initial code byte is 11 

X'81', and the dictionary reference in 
bytes 8 and 9 is that of the first label on 
the original BEGIN statement, if any. If 
there was no statement label, then the 
statement number occupies this slot. The 
presence of a statement number or statement 
label is indicated by a flag byte in 
position 35. This is set to SN for a 


2-3 

4-5 

6-8 


Length 

Hash chain (STATIC chain) 

Pointer to transfer vector 

Statement number. If the 
label is mentioned in an ON 
CHECK list, this slot 
contains the dictionary 
reference of Label BCD Entry 
(X'CE'), which has the 
statement number in bytes 4 
and 5 

Other 1 code byte. (See 
"First code byte - other 1" 
in Section 5 below. ) The 
last bit will always be set 
to one, unless the label is 
the last label for a 
particular statement, in 
which case the last bit will 
be set to zero. 
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12-13 Pointer to entry type 2 

14-16 Spare bytes for final 

assembly. The pseudo- code 
phase dealing with RETURN 
(expression) will insert 
into these bytes a code 
which must be stored in a 
specific slot in the DSA 
whenever the procedure is 
entered via this label. The 
code is used by the prologue 
construction phase. Byte 16 
in the first label for each 
PROCEDURE or ENTRY statement 
will contain the number of 
labels associated with that 
statement 

17 Block level 


3. for strings of adjustable 
length, the text 
reference of a second 
file statement giving the 
expression for the string 
length 

13-14 Picture table reference, if 

required. The storage allo- 
cation phase will change 
this to the dictionary 
reference of a DED entry, 
the picture table reference 
being moved into this refer- 
ence if necessary 


Entry Type 3 


18 

19 

20 
21 


Block count 

Count of containing block 
BCD length-1 
BCD of label 


Entry type 3 dictionary entries are 
constructed either from an explicit 
declaration or from implicit and default 
rules. Their format is as follows: 

Byte Number Description 

1 Code byte X'84* 


Entry Type 2 


An entry type 2 describes the data 
attributes of an entry point. The format 
is as follows: 


Byte Number Description 

1 Code byte X'85* . 

2-3 Length. 

4-5 Dictionary reference of 

entry type 3 

6-8 Offset, i.e., the position 

of the string dope vector in 
the DSA of the block to 
which the entry belongs. 

This will be zero if the 
item is not a string. 

9 DATA byte (see "DATA Byte" 

in Section 5 below) . 


10-12 Data information, which is: 

1. with numeric data, the 
precision and scaling, 
left justified 

2. for strings of fixed 
maximum length, the 
binary version of the 
string length in the two 
leftmost bytes of the 
data information 


2-3 

4-5 


6-7 


8-10 


11 


12-13 


14-15 


Length of entry . 

Dictionary reference of 
entry type 1 of PROCEDURE or 
ENTRY statement. 

Dictionary reference of 
entry type 2. This 
describes the value returned 
when the label associated 
with this entry type 3 is 
invoked as a function. 

The offset in the DSA of the 
containing block of the 
first approximation of the 
storage for the value 
returned by this entry 
point, when it is invoked as 
a function. 

The entry code byte. (See 
"Entry Code Byte" in Section 
3 below) 

The dictionary reference of 
an item in the AUTOMATIC 
chain of the containing 
block. Entry type 3 entries 
feature in the AUTOMATIC 
chain of the containing 
block. 

Switch bytes. The pseudo- 
code phase dealing with 
RETURN (expression) inserts 
into these bytes the bit 
pattern of the code which 
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will signify that entry to 
the procedure was by the 
label associated with this 
particular entry type 3. 
Phase QF will use this to 
create MVI instructions. 

16-17 Dictionary reference of a 

SETS list. This will be 
zero if the attribute SETS 
was not specified. The 
format of a SETS list is 
given at the end of this 
section. 

18-19 Dictionary reference of the 

dictionary entry for the 
label belonging to this 
entry type 3. 

20 Status byte. This byte will 
contain X*00* or X'FO*. 

X'00* indicates that the 
entry was constructed from 
an ENTRY declaration which 
had parameter descriptions. 
X*F0' indicates the entry 
was constructed either arti- 
ficially or from an ENTRY 
declaration which did not 
have parameter descriptions. 

21 2*n where n is the number of 
parameters. This is zero if 
the status byte is X'FF* 

22 onwards If the status byte is X*00' 

there are n two-byte 
references of parameter 
descriptions. A parameter 
description is a dictionary 
entry for the particular 
type of item but without a 
BCD. If one particular 
parameter is not described, 
i.e. if there are two 
adjacent commas in the ENTRY 
attribute , then the 
dictionary reference is 
zero. When the status byte 
is X'FO* then an entry type 
3 is only 23 bytes long. 

22+2n- DECLARE statement number 

23+2n 


SETS List Format 


Byte Number Description 

1 Code byte X*C8* 

2-3 Overall length of original 

BCD entry 


4-5 2*nl where nl is the number 

of identifiers in the SETS 
list. If * was specified, 
these bytes contain 2*nl+l. 

6-5+2*nl Dictionary references of the 
identifiers in the SETS 
list. 


6+2 *nl n2, the number of para- 
meters in the SETS list. 


7+2*nl n2 numbers of one byte each, 
onwards These are the parameter 
numbers and will be in 
ascending order. 


Entry Type 4 


Entry type 4 dictionary entries describe 
external entry points. Their format is as 
follows: 


Byte Number Description 


1 


Code byte X'03' 


2-3 Length 

4-5 Hash chain, later used 

as the STATIC chain 


6-8 


9-11 


12-13 


14 

15 

16-18 


Offset of the load constant 
in STATIC 

Offset in the DSA of the 
declaration block of the . 
storage for the first 
approximation of the value 
returned. 

The dictionary reference of 
an item in the AUTOMATIC 
chain of the declaring 
block. Entry type 4 entries 
are members of the AUTOMATIC 
chain of the declaring 
block. 

The Entry code byte. (See 
"ENTRY Code Byte" in Section 
3 below) . 

The DATA byte. (See "DATA 
Byte" in Section 5 below) 

Data information which iss 

a) with numeric data, the 
precision and scaling, 
left justified 

b) for strings of fixed 
maximum length, the 
binary version of the 
string length in the two 
leftmost bytes of the 
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GENERIC Entry Point 


19-20 

21-22 


data information 
c) for strings of adjustable 
length, the text refer- 
ence of a second file 
statement giving the 
expression for the string 
length 


The format for a GENERIC entry point is as 
follows : 

Byte Number Description 


Picture table address if 
required. 


1 Code byte X'02* 

2-3 Length 


Dictionary reference of a 
SETS list 


4-5 

Hash chain 

6-8 

Offset 1 Slot 


23 


24 

25 

25+2*n 

26+2*n 

27+2*n 

28+2*n 

onwards 


Status byte. If this byte is 
X^O* the meaning is the 
same as the status byte in 
an entry type 3. If the 
byte is X'FF' it is implied 
that no parameters were 
described 


2*n where n is the number of 
parameters. This is zero if 
the status byte is X*FF* 


n dictionary references to 
parameter descriptions as in 
an entry type 3 


Level 


Count 

BCD length-1 


9-10 


DECLARE statement number 


11 2n, where n is the number 

of two-byte addresses 
following 

12-11* 2n Pointers to entry type 4 

or 5, ENTRY labels, or 
BUILTIN entries. These 
entries are made when an 
identifier is given the 
attribute GENERIC. The 
pointers are to the entries 
which contain specifications 
of the various possible 
attributes 


12+ 2n Level 


13+2n Count 

14+2n BCD length- 1 

15+2n BCD 

onwards 


BCD of identifier 


3. CODE BYTES FOR ENTRY DICTIONARY ENTRIES 


Entry Type 5 


ENTRY Code Byte 


Entry type 5 dictionary entries describe 
the entry points which are formal 
parameters. They have the same format as 
entry type 4 except that: 


This code byte is used in entry type 3, 4, 
and 5 dictionary entries. The format is as 
follows : 

Bit Number Description 


Byte 1 is X* 83* 


0 IRREDUCIBLE 


Bytes 4 and 5 contain the address of 
the formal parameter type 1 entry 

Bytes 6 to 8 contain the offset in the 
DSA of the declaring block of the 
address slot associated with a formal 
parameter 


1 

2 

3 

4 


REDUCIBLE 

USES 

SETS 

SECONDARY 


No BCD is contained in the entry 


5 


RECURSIVE 
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6 


Has data attribute 


4. DICTIONARY ENTRIES FOR DATA. LABEL. 7N L 
STRUCTURE ITEMS 


7 


Not used 


Label Variables - Obtained from DECLARE 
Statement 


Options Code Byte 


Byte Number 

This code is used in entry type 1 

dictionary entries for PROCEDURE 1 

statements. The format is as follows: 


Bit Number 
0 
1 
2 

3 

4 

5 
b 


Description 

REENTRANT 

ON Block 

MAIN 

TASK 

RECURSIVE 

OPTIONS 

Contains RETURN (expression) 
statement 


Description 

Code byte may be X'07', 

X * 17 ' , X' 27 ' f X ' 37 ' , X ' 87 ' , 
X'97', X' A7 ' , X * B7 1 . The 
last four cases apply when 
the item occurred in a 
parameter list in a 
PROCEDURE or ENTRY 
statement. In this case, 
bytes 4 and 5 will contain 
the dictionary reference of 
the corresponding formal 
parameter type 1 entry. In 
the first four cases, bytes 
4 and 5 initially contain 
the hash chain. After the 
scan of the dictionary, this 
slot will be re-used to form 
another chain, e.g., 
AUTOMATIC or STATIC chain 


7 


ENTRY name is passed as 
argument 


2-3 Length 


Optimization Byte 


4-5 Initially contains the hash 

chain. After the dictionary 
scan, this is re-used to 
form another chain, e.g., 
AUTOMATIC or STATIC chain 


This code byte is used in entry type 1 
dictionary entries* 

Fermat of the Optimzation Byte: 

Bit Number Description 

0 Not eligible for D3A in 

library workspace. 

1 Eligible ^or DSA in STATIC 

storaoe. 


Needs invocation count. 

Needs current file slot. 

Contains asynchronous CALL. 

Indicates ORDER or REORDER 
option 


0 = ORDER, 

1 = REORDER. 
Default is ORDER 

6 Not used. 

7 Not used. 


6-8 


9-10 

11 


12 


13 


14 


15 


Offset inserted by storage 
allocation phase (as for a 
data item) 

DECLARE statement number 

'Other 1' code byte (See 
"First Code Byte - Other 1" 
in Section 5 below) 

'Variable' code byte (See 
"Variable Byte" in Section 5 
below) 

'Other 2' code byte (See 
'Second Code Byte - Other 2" 
in Section 5 below) 

'Other 3' code byte (See 
"Third Code Byte - Other 3" 
in Section 5 below) 

'Other 4' code byte (See 
"Fourth Code Byte - Other 4" 
in Section 5 below) 


lb onwards content determined by 
variable code byte. 
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After variable information 


17-19 


Data information, which is: 


2 bytes 
1 byte 
1 byte 
1 byte 


Symbol slot 

Level 

Count 

BCD length-1 
BCD 


With the exception of the 2-byte symbol 
slot, the general format is the same as for 
a structure. 


Dictionary Entries for Data Items 


The format is as follows: 


1. with numeric data, the 
precision and scaling, 
left justified 

2. for strings of fixed 
maximum length, the 
binary version of the 
string length in the two 
leftmost bytes of the 
data information 

3. for strings of adjustable 
length, the text 
reference of a second 
file statement qiving the 
expression for the string 
length 

4. Bit 0 of byte 19 
indicates that the 
temporary is used as an 
argument for halfword 
binary temporaries 


Byte Number Description 


1 


2-3 

4-5 

6-8 


9-10 


Code byte may be X' OF' , 

X* IF* , X'2F', X* 3F' , X* 8F* , 

X 1 9F' , X'AF', or X*BF'. The 
last four cases apply when 
the item occurred in a 
parameter list in a 
PROCEDURE or ENTRY 
statement. In this case, 
bytes 4 and 5 will contain 
the dictionary reference of 
the corresponding formal 
parameter type 1 entry. In 
the first four cases, bytes 
4 and 5 initially contain 
the hash chain. After the 
scan of the dictionary this 
slot will be re-used to form 
another chain, e.g., 
AUTOMATIC or STATIC chain 

Length 

See above 

Offset. (See "Format of 
Variable Information" in 
Section 6 below) 

DECLARE statement number. 

If the variable has not been 
explicitly declared, this 
number is zero; otherwise, 
it is the statement number 
assigned to the DECLARE 
statement from which the 
variable was obtained. 


11-16 Six code bytes. These are: 

other 1, variable, other 2, 
other 3, other 4, and data. 
(See "Code bytes" in Section 
5 below for a description of 
these bytes.) 


Note : In the case of a 
temporary data variable for 
an argument, the first bit 
of byte number 19 is set to 
1 by phase GP. It is set to 
0 by phase IM for temporary 
arguments to built-in 
functions and 
pseudo-variables. It is 
examined by phase QU. 

20-21 Symbol slot, containing 

either zero, or one of the 
following: 

1. If the SYMBOL and DED 
bits are not on, and the 
data item has a picture, 
these bytes contain the 
dictionary reference of 
the picture table entry 

2. If the DED bit is on and 
the SYMBOL bit off, this 
slot points at a DED 
entry. If the item has a 
picture, the DED entry 
will contain the picture 
table address 

3. If the SYMBOL bit is on, 
the slot will point at a 
SYMBOL entry. This again 
will contain the picture 
address, if specified 

22 Variable information. The 

contents of these bytes are 
determined by the variable 
code byte. (See "Format of 
Variable Information" in 
Section 6 below) 

1 byte Level 

1 byte Count 
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1 byte BCD length-1 
BCD 


Major and Minor Structure Entries 


These entries do not include base elements, 

i.e., they do not have any data attributes 
or LABEL. Their format is 2 


Byte Number 


Description 


1 Code byte may be X*2E', 

X* 3E* , X* AE* , or X'BE*. The 
last two indicate that there 
is no BCD attached. When 
the identifier occurs in the 
parameter list of a 
PROCEDURE or ENTRY 
statement, bytes 4-5 contain 
the dictionary reference of 
the formal parameter type 1 
entry. In the case of the 
first two code bytes, bytes 
4-5 of the entry initially 
contain the hash chain. 

This is later modified by 
Phase FT 


2-3 Length 

4-5 See byte number 1 

6-8 These bytes are used by the 

storage allocator; they will 

finally contain one of the 
following offsets: 

1. For structures which are 
parameters, or are 
dynamically defined, the 
offset from the start of 
the major structures dope 
vector or the minor 
struct tires dope vector. 

2. For major structures, the 
offset from the start of 
AUTOMATIC or STATIC Of 
the address slot which 
will point at the 
structure dope vector 

3 . For CONTROLLED 
structures, only that 
specified for minor 


structures in 1 , above 

4. For structures in 
STATIC EXTERNAL the 
contents depend on the 
setting of the "dope 
vector required" bit in 
the "other 3" code byte. 
If this bit is off and 
the item is a major 
structure, the slot 
contains the offset from 
the start of STATIC of 
the slot which will 
contain the address of 
the first byte of the 
structure. If the dope 
vector bit is on, the 
slot contains the offset 
from the start of STATIC 
of the address slot which 
will point at the 
structure dope vector. 

The offset slot is not 
used in either of the 
above cases for minor 
structures 


9-10 DECLARE number, i.e. the 

statement number of the 
DECLARE statement which 
produced the structure 

11-15 Five code bytes. These are: 

other 1, variable, other 2, 
other 3, and other 4 

16 Variable information. The 

content is determined by the 
variable code byte, and will 
always include the 
information required for 
structure members. (The 
format is described under 
"Format of Variable 
Information" in Section 6 
below) 

After variable information: 

1 byte Level 

1 byte Count 

1 byte BCD length- 1 

BCD 
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5. CODE BYTES FOR DATA, LABEL. AND STRUCTURE DICTIONARY ENTRIES 
The First Code Byte - Other 1 


r Bit 

No. 

K 

o 




Description 

Symbol or requires load constant if 
label constant 




Defined on 

Mentioned in CHECK list 

Needs DVD 

Last member in structure 
Variable dimensions 

* dimensions 

* string length for data item 

— More labels follow for a label 
constant 

Major Structure - no member of 

the structure has a dimension or 
length attribute which is not * 


Set By 

Phase EL, FT, or 
NU 


Phase EL 

Phase FO 

Various 

Phases EL or EW 
Phase EL 

Phases EL and FT 
Phases EL and FT 
Phase EG 

Phase EY 


The Second Code Byte - Other 2 


r 

| Bit 
j No. 

[ o 

| Description 

1 

j Dynamically defined 

i 

j Set by j 

i 1 

j Phase EL | 

i 1 

| 1 

1 

| CONTROLLED major structure with 
j varying strings 

1 

1 1 

j Phase EY j 

1 1 

I i 

1 2 

| NORMAL = O, ABNORMAL = 1 

i 

1 1 

| Phases El and FT | 

1 1 

1 3 

i 

| Reserved 

1 

1 1 

i 1 

1 4 

1 

| Formal Parameter 
| 

1 1 

j Phase El j 

i i 

1 3 

1 

j INTERNAL = 0, EXTERNAL = 1 

i 

| Phase El | 

1 1 

1 6 

j and 

i 

| 00 = AUTOMATIC or DEFINED or simple 

| parameter 

1 

1 

1 1 

| Phase EL j 

I 1 

1 1 


! 

j 01 = STATIC 

1 I 

| Phase EL f 

1 1 

1 7 

1 

| 11 = CONTROLLED 

1 1 
| Phase EL 1 
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The Third Code Byte - Other 3 


r - 

— — - 

“T” 





Bit 

1 


1 



No. 

1 

Description 

j Set by 


h 


-+- 





0 

1 

Needs dope vector 

| Phases EK and EY if variable 




1 


j dimension entries, variable 




1 


j string length, or in 




1 


j CONTROLLED storage; 




1 


j Phase NU when item appears 




1 

I 


j in an argument list 

i 



1 

1 

1 

1 

Needs DED 

1 

j Phase NU 
■ 



2 

1 

1 

Needs no storage for the item 

1 

| Phase GP 




1 

1 

itself 

1 

1 



3 

1 

1 

l 

Correspondence defined 

■ 

j Phase FV 

i 



4 

1 

1 

1 

Chameleon 

l 

j Phase GP 
i 



5 

1 

1 

Data Variable UNSAFE 

i 

| Set by phase KE 




1 


| 1= UNSAFE 




1 


j 0= SAFE 




1 


j This use is local to the 




1 

1 


j K phases 

i 




1 

1 

Sign bit for first offset 

1 

j Phase PH for STATIC and 




1 


j Phase PT for AUTOMATIC 

1 



6 

1 

1 

Indication of the state of 

1 

j Phase PH for STATIC and 




1 

the value in the first offset 

j Phase PT for AUTOMATIC 




1 

0 = rubbish 

1 




1 

1 

1 = good value 

1 

l 



7 

1 

1 

As above but for second 

1 

| Phase PH 




| 

address slot 

1 


L. 


-X. 

_ . - 
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The Fourth Code Byte - other 4 


Bit 

No. 


Description 


)- 

— ... i — mm — » — — — — — — — 



— 

— 1 

1 0 

j Usage (i) : 

j Phase 

EL (for 

EW) 


1 

1 

| An explicit alignment 

1 declaration has been made 





1 

j Usage (ii): 

j Phase 

JK 



1 

1 

1 

1 A constant has been produced 

j for this structure or array 

i 





1 

1 1 

1 

| 00 = Not temporary 

| Phase 

GP, HF, 

HK, 


j and 

| 01 = Temporary type 2 

| IM, or LB 



1 2 

1 

I 

j 10 = Temporary not sold 
j 11 = COBOL temporary 

1 

1 

1 

1 




1 

1 3 

1 

j Member of defined structure 

I 

1 

| Phase 
| 

FV 



1 

1 

1 

1 

| Packed = 0 Aligned = 1 

i 

1 

| Phase 

i 

EL 



1 

1 5 

i 

1 

| Major structure 

1 

| Phase 

1 

EL 



1 

1 6 

1 

| No dope vector initialization 

| Phase 

1 

GP 



1 

1 7 

1 

1 

1 

1 

| A temporary type 2 which has 
j been incorporated in work- 
| space 1 or RDV required. For 
j COBOL temporaries this bit 

1 

| Phase 

1 

1 

1 

OB 



1 

1 means RDV required 

1 



J 

Variable Byte 





j Bit 

| Description 

— 

1 




j No. 

\ o 

1 

1 

1 

4 

1 

1 




j Second address slot 




1 

1 1 

I 

1 

| Dimensioned 

a 

1 

1 

i 




1 2 

i 

| Member of structure 

1 

1 

• 




I 

1 3 

i i 

I Value list for label variables or 1 




1 

j POS for defined items 

1 





Set by 


Initial value if not a structure 
or LIKE if a structure 

EXTERNAL slot 

Defined slot 


CONTROLLED from ALLOCATE statement 




— J 


For a detailed explanation of the 
significance of these bits and a 
description of the extra slots associated 
with them, see "Format of Variable 
Information" in this Appendix. 
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Data Byte 


T 




BIT 

1 o | 

1 1 

_J x_ 

l 

1 

1 

_X_ 

2 | 

J 

3 

1 

1 

_x_ 

4 

i 

1 

i 

5 

1 

1 

i 

6 

1 

1 

1 

1 

7 | 

1 

J 


CAD or 

T T 

1 i 1 

POINTER/ 

T 

1 

Sterling j 

Long 

T 

1 

Cad. 

T 

1 

Binary 

T 

1 

Float 

+“ 

1 

Complex | 

1 

NUMERIC 

1 1 

OFFSET ♦ 

1 

NON | 

Short/ 

1 

Numeric 

1 

Decimal 

1 

Fixed 

1 

Real | 

0 

FIELD 

j j 

I 

_X_ 

STERLING j 

X 

OFFSET 

1 

_X. 

Field 

1 

1 

| 


1 

i , 

1 


STRINGS 

i i 

1 o | 

Adjustable 

T 

1 

T 

Aligned | 

Varying 

T 

1 

No 

i 

1 

Char 

T 

1 

AREA 

T 

1 

| 

Not i 

1 


1 1 

Length 

1 

1 


1 

Picture 

1 


1 

VAR I- 

1 

Used | 



1 1 

String 

1 

Unaligned | 


1 

Picture 

1 

Bit 

1 

ABLE* 

1 

1 

0 




♦AREA, POINTER, and OFFSET data byte settings are: 

AREA: X*02* superimposed on the non- pictured CHAR string data byte entry 

POINTER: X'40* superimposed on the FIXED BIN data byte entry 

OFFSET: X*50* superimposed on the FIXED BIN data byte entry 

Note: The LONG bit X'10* is set to 1 for halfword binary and 0 for fullword binary 


6. FORMAT OF VARIABLE INFORMATION 


Data items, labels,, and structures require 
pointers to various tables if they have 
certain attributes; for example, if they 
are dimensioned or defined on a base. 

Space will be left for information only if 
the attribute is present. This leads to an 
addressing problem of how to find the 
position of the information when the 
presence of other attributes alter its 
address. 

The problem is resolved by collecting, 
into one byte, all the attributes which 
require more than one bit to describe them. 
This has taken the second place in all the 
collections of attribute bytes. The 
presence of a bit in this byte indicates 
the presence of further information. The 
offset of this information from the start 
of the variable information is given by the 
presence of the bits to the left of the one 
of interest. Each bit will have a value 
associated with it. The sum of the values 
of the bits present and to the left of the 
one of interest will give the value of the 
offset. This is achieved in the coding by 
moving the code byte, masking off the bits 
to the right of the one being tested and 
the bit itself,, and translating the byte. 


dictionary entry is based on questions 
about the nature of the identifier. 
Refer to Figure 10. 
r~i 

|Y| implies that a second offset 

i— J ■ slot will be given, 

r~i 

|N j that it will not. 
i j 


Bit number 1: 

The dimensioned bit. The slot produced 
by this is three bytes long. The first 
byte will contain the number of 
dimensions, the next two the dictionary 
reference of the dimension (multiplier) 
table 

Bit number 2: 

Member of a structure bit. This slot 
is ten bytes long and has the following 
format: 

Byte Number 

1 

2 

3-4 


Description 

Declared level number 

True level number 

Dictionary reference of 
the containing structure 


The information produced by the presence 
of the following bits in the variable byte 
is as follows : 

Bit number 0: 

The second offset slot is 4 bytes long. 
The contents of this slot are described 
in this appendix. The decision to 
include a second offset slot in a 


5-6 Dictionary reference of 

the next member in the 
structure 

7 Alignment 

Note: The value held in this 
byte corresponds to ELEMENT 
size (in bits) and would be 
one of the following: 
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X* 01* - BIT alignment 
X'08* - CHAR alignment 
X ' 10 * - HALFWORD al ignment 
X* 20* - FULLWORD alignment 
X* 40* - DOUBLEWORD alignment 

8-10 Element length 

Bit number 3: 

POS for defined items. The two-byte 
slot will contain the POS value as a 
b incur y integer. 


contain the LIRE chain. The third 
and fourth bytes contain the 
dictionary reference of the likened 
structure 

Bit number 5: 

The EXTERNAL bit. This 2- byte slot 
contains the ESD number 

Bit number 6: 

The DEFINED bit. This 7-byte slot 
contains the following: 


Bit number 4: Byte Number Description 

The initial value or LIKE bit is a 

four-byte slot. 1-2 Defined chain. 


1. For normal initial value. The first 
two bytes contain the dictionary 
reference of the associated * Initial 
Value* dictionary entry. The fourth 
byte contains x*F0* 

2. For INITIAL CALL. The first three 
bytes contain the text reference of 
a second file statement. The fourth 
byte contains X*0F*. 

3. For initial labels. The first three 
bytes contain the text reference of 
a set of second file statements. 

The fourth byte contains X* FF* . If 
there is an initial slot but no 
initial values the fourth byte 
contains X'OO* 

4. For LIKE. The first two bytes 


3-4 Dictionary reference of base 

5-7 The text reference of a 

second file statement. 

After the dictionary these 
bytes will contain X'FFFFFF' 
if the base is 
unsubscript ed . 

Bit number 7 : 

The CONTROLLED from ALLOCATE bit. This 
bit is on for dictionary entries for 
level 1 CONTROLLED data specified in 
ALLOCATE statements. The two- byte slot 
contains the dictionary reference of 
the dictionary entry for the data 
constructed from the DECLARE statement 
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| Entry 


‘i 

I 

j 


Y j Is it data | 
| item? j 

In 

v 


| Is it struc- | N 
j ture? )— 



YV 


f Is it label ]n r -«, 
>j^ variable? |. — > | n | 

T y 


| Is it formal 

|Y 

j parameter? 

V 

1 /y 

1 


IN 

1 

> 

1 

r 

| Is it con- 

”1 1 
|Y 1 

I 

1- J 

j trolled? 

^ “ — T 

1 

.J 

IN 


V 


1 

|Y 

| Is it static? 
1 

l _ 

_J 


N | <— 


V 




| Is it struc- | N r -T 
>j ture member? |» — >|N| 



V 


r~T 

m 

L_J 


j Is it ex- 

>1 

| ternal? 

In 


|Y r-i 
h — >|Y| 

I 


I l Y r— i 

| Is it string? j- — > | Y | 

In 

v 

| Is it struc- | Y r -T 
j ture meniber? f — > | Y | 

In" 

v 


I I Y 

j Is it defined?)* — >|Y| 

In 

v 

| Is it dimen- |Y r ~| 

j sioned? )• — >|Y| 

L T I l — J 

IN 

V 


I N | 

I I 

Figure 10. Decision to Include a Second offset slot 
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uses of the 0FFSET1 and OFFSET 2 Slots in 
Data, Label, and Structure Dictionary 
Entries 


The OPPSETl slot is in bytes 6-8 of the 
dictionary entry and the 0FFSET2 slot is 
part of the variable information. 


STATIC INTERNAL Structures 


Major and minor structure entries: 

OFFSETl slot not used. OFFSET 2 slot 
contains offset of structure dope 
vector from start of STATIC INTERNAL 
control section (if there is a dope 
vector) 

Basic elements: OFFSETl slot contains 
offset of virtual origin (in the case 
of dimensioned items) or offset of item 
(when not dimensioned) from start of 
STATIC INTERNAL control section. 

OFFSET 2 slot contains offset of dope 
vector (if there is one) from start of 
STATIC INTERNAL control section 


AUTOMATIC Structures 


Constant dimensions: as for STATIC 
INTERNAL except that all offsets are 
relative to start of DSA. 

Adjustable dimensions s major and minor 
structure entries: OFFSETl slot not 
used. OFFSET 2 slot contains offset of 
structure dope vector from start of DSA 
(if there is a dope vector) 

Basic elements: OFFSETl slot not used. 
OFFSET 2 slot contains offset of 
element's dope vector (if there is one) 
from the start of the DSA 


STATIC EXTERNAL and Parameter Structures 


Major structure entry; OFFSETl slot 
contains offset of address slot from 
start of data region. 0FFSET2 slot 
contains size of EXTERNAL control 
section. (Offset of major structure 
dope vector = 0.) 

Minor structure entries: OFFSETl slot 
not used. OFFSET2 slot contains offset 
of structure's dope vector from start 
of major structure dope vector. 


Basic elements: OFFSETl slot not used. 
0FFSET2 slot contains offset of 
element's dope vector from the start of 
the EXTERNAL control section 


CONTROLLED Structures 


Major and minor structures: OFFSETl slot 
not used. OFFSET2 slot contains offset 
of structure dope vector from point to 
which pseudo register points. (In the 
case of the major structure, this value 
will be zero.) 

Basic elements: OFFSETl slot not used. 
OFFSET 2 slot contains offset of 
element's dope vector relative to 
address in pseudo- register . 


Non- 1 - Structured Arrays in STATIC INTERNAL 


OFFSETl slot contains offset of vertical 
origin of the array relative to start of 
data region. 0FFSET2 slot contains offset 
of dope vector (if there is one) from the 
start of the data region. 


Non- Structured Arrays in AUTOMATIC 


Constant dimensions: as for STATIC 
INTERNAL 

Adjustable dimensions: OFFSETl slot not 
used. OFFSET2 slot contains offset of 
dope vector from start of data region. 


STATIC EXTERNAL, CONTROLLED or Parameter 
Array 


OFFSETl slot contains offset of address 
slot which contains a pointer to the arrays 
dope vector. (Not used in the case of 
CONTROLLED.) OFFSET2 slot is not present. 


Non- Structured Scalar Strings in STATIC 
INTERNAL 


OFFSETl slot contains offset of datum from 
start of data region. OFFSET2 slot 
contains offset of dope vector (if there is 
one) from start of data region. 
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count 


BCD length-1 
BCD 
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N on-Structured Scalar Strings in AUTOMATIC 


Constant length: as for STATIC INTERNAL 

Adjustable length: OFFSETl slot not 
used. OFFSET2 slot contains offset of 
dope vector from start of data region. 


Non-Structured Scalar Strings in STATIC 
EXTERNAL. CONTROLLED or Parameter 


OFFSETl slot contains offset of address 
slot which points to string dope vector 
(not used in the case of CONTROLLED) . 
OFFSET 2 slot not present. 


11 

Other 1 Code Byte (See 
"First Code Byte - Other : 
in Section 5 above) 

12-14 

Second Offset Slot 

15-16 

spare for Final Assembly 

17 

Level 

18 

Count 

19 

Count of Containing Block 

20 

BCD Length- 1 

21 etc. 

BCD 


Non-Structured Non- String Scalars in Compiler Labels 

AUTOMATIC or STATIC INTERNAL 


OFFSETl slot contains offset of datum from 
start of data region. 0FFSET2 slot not 
present. 


Non-Structured Non- String Scalars in STATIC 
external, controlled or Parameter 


The format is identical to that of a label 
constant, except for the omission of the 
BCD. The code byte is X*C3'. If the 
compiler label has been constructed for a 
label variable, then the BCD for the label 
and its subscript will follow on behind the 
entry and the total length of the entry is 
given in bytes 2-3. 


OFFSETl slot contains offset of address 
slot which points to datum (not used in the 
case Of CONTROLLED). 0FFSET2 slot not 
present. 


7. OTHER DICTIONARY ENTRIES 


Formal parameter type 1 entry 


These entries are derived from the 
PROCEDURE and ENTRY statements, and do not 
contain any information other than that the 
identifier is a formal parameter. The 
format is as follows: 


Byte Number 

Label Constants - Extracted by the Read-In 

Phase 1 


Description 
Code byte X'40* 


2-3 Length 


Byte Number Description 


4-5 Hash chain 


1 Code byte X*00' 

2-3 Length up to BCD length-1 

byte 

4-5 Hash chain - STATIC chain 

6-8 Offset 

9-10 Statement number (except 

when the label is mentioned 
in an ON CHECK list, in 
which case it gives the 
chain to the label BCD 
dictionary entry, code byte 
X * CE ' ) 


6-7 These bytes will point to a 

full description of the 
identifier after Phase EK, 
or Phase FA, or Phase FE. 
These full descriptions are 
dictionary entries for the 
type of item they are 
describing. They do not 
contain the BCD of the 
identifier, but in the slot 
for the hash chain there is 
the dictionary reference of 
the corresponding formal 
parameter type 1 entry. 

8 Level 
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16 


Level 


For a description of the types of entry 
pointed to, see "Dictionary entry for 
parameter descriptions." 


Dictionary entry for FILE 


For attributes specified in OPEN statement 
the format is as follows: 

Byte Humber Description 


1 Code byte X'98* 

2-3 Length 

4-5 STATIC chain 


17 Count 

18 BCD length- 1 

19 onwards BCD 


FILE Parameters and Temporaries 


Code X* 89* is used for file parameters and 
for file temporaries. The format of the 
entry will be the same as that for label 
variables. 


6-8 

9-10 


OFFSET1 

DECLARE statement number 


FILE Environment Entries 


11 onwards String of second level 

markers (without preceding 
*C8* code bytes) one for 
each attribute other than 
FILE, TITLE and IDENT. 

This entry is created by the read- in 
phase and is referred to only as the 
argument of an ATTRIBUTES marker. 


FILE Constants 


Code X*08 * is used for file constant 
entries, which have the following format: 


Code X' C8 ' is 
string. 

Byte Number 

1 

2-3 


used for the environment 

Description 
Code byte X'C8' 

Length 


4 onwards Internally coded form of 
argument of ENVIRONMENT 
option 

Code X* C8 * is also used for attributes 
collected from the DECLARE statement. 


Byte Number Description 


Byte Number Description 

1 Code byte X'08* 

2-3 Length 

4-5 Hash chain, subsequently 

EXTERNAL or STATIC chain 

depending on whether FILE is 
EXTERNAL or INTERNAL 


1 Code byte X'C8* 

2-3 Length 

4 onwards String of second level 

markers (without preceding 

code bytes X'C8'), one for 
each attribute other than 
FILE, ENVIRONMENT, EXTERNAL, 
or INTERNAL 


6-8 

OFFSET1 

(STATIC or transfer 


vector offset) 

9-10 

Declare 

statement number 


Dictionary Entries from Constants 


11-12 


13 


14-15 


Dictionary reference of The format is: 

attributes entry (zero if 

none) Byte Number Description 


Code byte (similar to the 
"other 2" code byte. Only 
internal/exteraal bit used) 


1 Code byte X'88' 

2-3 Length 


Dictionary reference of 4-5 

environment string (zero if 

none) 6 


Hash chain 
DATA byte 
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7 Data Precision* 


8 Scale Factor* 


♦These are the apparent 
precision and factor derived 
from the BCD of the constant 
(see Note 2) 

9 Type (see note 1) 

10 DATA byte (2) 

11 Data Precision (2)** 

12 Scale Factor (2)** 

♦♦These bytes are inserted 
by the phase requesting 
conversion. If a picture is 
required, these bytes are 
used to contain a picture 
table reference (see Note 3) 

13-14 Dictionary reference - used 

when a phase requires a 
constant to be converted 
into a specific location in 
storage 

15 BCD 

Notes ; 


Seventh bit: 1 indicates that the 
constant requires a dope vector. 


Eighth bit: 1 indicates that no 
conversion is required. 


2. After the constants processor the 
bytes 6 through 8 will contain the 
offset of the constant from the start 
of the pool of constants. If a dope 
vector is requested then the offset of 
this from the start of the constants 
pool is eight less than that of the 
converted constant. 

3. Should a DED be required, this will be 
constructed by Phase PL. The two 
bytes, precision (2) and scale 

factor (2), will contain a dictionary 
reference of a DED dictionary entry. 

If the constant requires a dope vector 
then Phase OS will make a dictionary 
entry for it, and the dictionary 
reference preceding the BCD will be 
the dictionary reference of this. 


Task Identifiers and EVENT Data 

The format of the dictionary entries for 
task identifiers and EVENT data is, apart 
from the initial code byte, the same as 
that for a label variable. 


1. The type byte has the following 

meaning: Dictionary Entries for Built-in Functions 


First and second bits: 


The format is: 


00 - normal BCD constant. The first 
offset slot must be 
relocated by the storage 
allocation phase, to 
contain the offset of the 
converted constant from the 
start of STATIC storage, 
rather than from the start 
of the constants pool 

11 - the BCD is replaced by the 
internal form of the 
constant. The first offset 
slot is treated in the same 
way as for the code 00 


Byte Number 
1 


2-3 


4-5 


6-8 


9-10 


10 or 01 - the constant is required to 
be converted into a 
specific location in 
storage. The second code 
implies the converted 
constant should be made 
negative before being 
stored 


Sixth bit: 1 indicates that the 

constant requires a DED. 11-12 


Description 
Code byte X*04* 

Length 

Hash chain - later becomes 
the STATIC chain 

Offset - gives the position 
in STATIC storage of the 
load constant for Library 
routine 

Code bytes - the first code 
byte contains a value which 
identifies the built-in 
function and also provides 
information about it. It is 
used mainly by phases IM and 
MD-MM inclusive. The second 
code byte contains further 
information about the 
built-in function (See 
"Second Code Byte.") 

DECLARE statement number 
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13 

Level 


further information about 
the function 

14 

Count 

13 

Level 

15 

BCD length-1 

14 

Count 

16 

BCD 




Second Code Byte 


BCD entries 


The second code byte contains the following 
informations 


Bit Number 
0 
1 


Description 

May be passed as an argument 

May have an array as an 
argument 

Must have an array as an 
argument 

Is a pseudo- variable 

Indicates to which of the 
two tables the offset refers 

May have an array (or 
structure) as an argument , 
but will return a scalar 
result 


Internal Library Functions 


Library routines, other than built-in or 
GENERIC functions, are known as Internal 
Library Functions. Their dictionary entry 
format is as follows: 


Byte Number 
1 

2-3 

4-5 

6-8 

9 

10 

11-12 


Description 
Code Byte X*C2* 

Length 
Hash chain 
Offset 

Library code - identifies 
the particular Library 
routine required 

Not used 

Code Bytes - the first code 
byte contains a value used 
by phase MG to pick up 
complete information about 
the library function. The 
second code byte contains 


BCD entries are used when the LIKE or 
DEFINED attributes are used. A short 
dictionary entry with the format given 
below is used. This is pointed at by the 
dictionary entry with the attribute. 


Byte Number 
1 

2-3 

4 


Description 

Code Byte X'40' 

Length 

BCD length- 1 

BCD 


Dictionary Entry for Parameter Descriptions 


Dictionary entries for parameter 
descriptions are identical with the normal 
entry for data variable, label variable, 
structure, file, or entry points, except 
for the following details: 

Hash chain contains pointer to formal 
parameter type 1. After Phase FT this 
pointer is moved to the bytes 
containing level and count 

No BCD is present 

No block identification is present for 
ENTRY or FILE 

The code byte for an entry point - 
referred to as entry type 6 - is X'86* 


ON Statements 


Entries for ON statements are made by Phase 
FO, and contain the following: 


Byte Number 
1 

2-3 

4-5 


Description 
Code Byte X'CD' 
Length 

AUTOMATIC chain 
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6-8 

Offset 

PICTURE Entry 


9 

Code byte as supplied by the 

The format of an entry in the picture table 


Read- In Phase 

in the dictionary. 



Byte Number 

Description 

10 

Block level 

1 

Code Byte X'C8* 

11 

Block count 

2-3 

Length = L+13 

12 

n 

4-5 

Contains address of next 
entry in picture chain 

13 onwards 

n dictionary references of 
variables or ON condition 

6-8 

Usage (1) (Before Phase FQ) 


entries 


Dictionary reference of 
associated declare or format 




statement, right adjusted 




Usage (11) 

ON Condition 



Offset in STATIC storage 



9 

Code Byte (after Phase FQ) 

This entry is made by Phase FO: 


(See Code Byte description) 

Byte Number 

Description 

10 

P - the number of digit 
positions in field in 

1 

Code Byte X'4D' 


numeric picture. 

2-3 

Length 

11 

Q - the number of digit 
positions after V character 

4-5 

Hash chain later used as 


in numeric picture. Code 


AUTOMATIC chain 


X'80* represents 0, X*7F* 
represents -1, and X'81' 

6-8 

Offset 


represents +1. 

9 

Code byte as supplied by the 

12 

W - apparent length of 


read in phase 


picture. - length of 
picture following. (For a 

10 

Block level 


non-numeric picture the 
length is obtained in bytes 

11 

Block count 


12-13.) 

12 

BCD length- 1 

14 onwards 

Picture. 

13 onwards 

BCD 




Byte 9 - Code Byte 


CHECK List Entry 


This entry is made by Phase FO: 
Byte Humber Description 

1 Code Byte X'C8' 


Bit Number 


2-3 Length 

4 n where n is the number of 

dictionary references 
following 


5 onwards Dictionary references (2n 
bytes) 


2 

3 

4 


Description 

0 string 

1 numeric 

0 correct 

1 error 

0 not sterling 

1 sterling 

0 short 

1 long 

Not used 
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5 


9-10 


Dictionary reference or 
DECLARE number 


0 decimal 

1 binary 

6 0 fixed 

1 floating 

7 Not used 

Dictionary Entry for Workspace Requirement 


11 onwards Bit pattern of skeleton dope 
vector 

This entry is constructed by Phase PD 


The format for a dictionary entry for Symbol Table Entry 

workspace requirement is: 


Byte Number 

Description 

Symbol table 

entries are made by Phase PL. 

1 

Code Byte X'C8' or X'CA' 

Byte Number 

Description 

2-3 

Length = 8 

1 

Code Byte X*C7' 

4-5 

Total workspace required 

2-3 

Length 

6-8 

Offset 

4-5 

STATIC chain 

If the code byte is C8 this is the 

6-8 

Offset in STATIC of DED 

temporary workspace used by pseudo-code 
(temporary type 1) . 

9-11 

Actual DED if not pictured. 




If a picture is involved, 
the last two bytes are the 
dictionary reference of the 

Dictionary Entry for Parameter Lists 


picture table entry 



12-13 

Offset in STATIC storage of 

Dictionary entries for parameter lists have 


symbol table entry 

the following 

format: 

| 14-15 

Dictionary reference of next 

Byte Number 

Description 


item in the symbol table for 
this block 

1 

Code Byte X'C5' 

| 16-17 

Dictionary reference of item 

2-3 

Length 


requiring entry in symbol 
table 

4-5 

STATIC chain 



6-8 

STATIC offset 



9-10 

Assembled length 

Dictionary Entry for AUTOMATIC Chain 



Delimiter 


11 onwards 

Contains DC A* s 

An entry for 

AUTOMATIC chain delimiter is 



made by Phase PP. 

Dictionary Entries for Dope Vector 



Skeletons 


Byte Number 

Description 



1 

Code Byte X'CC* 

Byte Number 

Description 

2-3 

Length 

1 

Code Byte X*C6* 

4-5 

AUTOMATIC chain 

2-3 

Length 

6-7 

Pointer to first second file 
entry 

4-5 

STATIC chain 

8-9 

Pointer to second second 

6-8 

Offset in STATIC 


file entry 


Appendix C: Internal Formats of Dictionary Entries 409 



PEP Dictionary Entn 


Byte Number 


Description 


An entry for a PEP is created by Phase PL. 


Byte Number 


Pescription 
Code Byte X'C7' 
Length 


STATIC or AUTOMATIC chain 


Code Byte X'Cl' 
Length = 12 


STATIC chain 


STATIC offset 


Actual FED 


Offset 


11-18 


19-20 


Dictionary reference of 
variable 

Eight bytes of RDV text 
DECLARE number 


Label BCD Entries 


Label BCD entries are made by Phase FO. 
Byte Number Description 


The LONG bit X’10* of byte 9 is set to 1 
for halfword binary and 0 for fullword 
binary. 

If the DED requires a picture, the last 
two bytes contain the dictionary reference 
of the picture table entry. 

This entry has the same format as the 
first eleven bytes of a symbol table entry. 
No item will require both types of entry. 
The type required will be chained from the 
symbol slot in an item. 


PEP 2 Entries 


These entries are generated when a DED is 
required for the conversion of a temporary 
result. 


1 Code Byte X'CE* 

2-3 Length 

4-5 DECLARE number 

6-7 Offset of the BCD 

in STATIC 

8-9 Dictionary reference of item 

requiring BCD 

These entries are constructed when a 
statement label or a PROCEDURE or ENTRY 
label is mentioned in an ON CHECK list. 
These entries are also made for EVENT and 
TASK variables. Phase PD will allocate 
storage in STATIC for the ECD of the label, 
and place the offset of this in the above 
entry. 


Byte Number 


Description 


Dope Vector Entries for Temporaries 


Code Byte X'Cl' 
Length = 11 
STATIC chain 


This entry is constructed to indicate that 
a dope vector is required for a temporary 
result. At this stage the bytes in the 
entry contain the followings 


Offset 


Byte Number 


Description 


Actual DED 


Dictionary Entry for FED - Format Element 
Descriptor 


The entry for a FED is made by Phase NV. 

The entry is identical with a DED2 entry 
but with a length of 12, instead of 11. 

The storage allocated will be word-aligned. 


code Byte X'CO* 

Length 

AUTOMATIC chain 

Offset in the temporary type 
1 stack. After Phase QJ 
this will contain the offset 
from the start of the DSA 

Dictionary reference of dope 
vector skeleton entry 
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11-12 


Length of string 


Record Dope Vector Entry 


6-7 Dictionary reference of the 

entry type 1 of the block 

from which the second file 

statement was extracted 


This entry is constructed when a variable 
requires a record dope vector. 


8-9 Dictionary reference of a 

three-byte slot in the 
dictionary. 


Byte Number 
1 

2-3 

4-5 

6-8 


Description 
Code Byte X'C29’ 

Length 

STATIC or AUTOMATIC chain 
Offset 


10 Type of second file 

statement, i.e. the 
function it performs. This 
is the second byte of the 
dictionary reference used to 
designate the function in 
the actual second file 
statement 


9-10 Dictionary reference of 

variable 


Dictionary Entry for a STATIC PSA 


11-18 Eight bytes of RDV text 

19-20 DECLARE number 

Dope Vector Descriptor Entry 

This entry is constructed for a structure 
which requires a dope vector descriptor. 


Byte Number 

Description 

1 

Code Byte X*CC* 

2-3 

Length 

4-5 

STATIC chain 

6-8 

Offset 

9-10 

Dictionary reference of 
structure 

11-12 

Chain to RDV entry or 
DECLARE number 

13.. . 

DVD text set up by phase JK 

Format of a 

Second File Dictionary Entry 

Byte Number 

Description 

1 

Code byte X'C8* 

2-3 

Length of entry 

4-5 

Statement number of the 
DECLARE or other statement 
giving rise to the second 
file statement 


This entry is made by phase PA (whenever a 
block has its DSA in STATIC). The "size of 
DSA" slot (right-hand two bytes) in the 
Entry Type 1 is used to contain the 
dictionary reference in this entry. 


Byte Number 

Description 

1 

Code byte X'C8* 

2-3 

Length = 20 

4-5 

Dictionary reference of the 
next STATIC DSA entry, or 
zero if this is the last 
entry. 

6-7 

Offset address slot in 
STATIC for the DSA (set by 
phase PD) . 

8-10 

Size of DSA (set by PT and 
amended by RF) . 

11-12 

Dictionary reference of the 
Entry Type 1 of the block. 

13 

Code byte to be put into 
first byte of DSA.. 

14-16, 

Offset of start of DSA in 
STATIC (set by phase TO). 

17-18 

Head of block’s automatic 
chain. 

19-20 

Not used 


Dictionary Entry for an Error Message 


Byte Number Description 

1 Code byte X'C8' 

2-3 Length 

4-5 Chain 

6-7 Messages number 

8 Flags: 

Bit 0 on if text to be 

inserted in message 
1 on if statement number 
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Description 


to be inserted 

2 on if a numeric parameter 
to be inserted 

3 on if a dictionary 
reference to be inserted 

4-7 Severity: X*0* Termin- 
ation 

X * 4 ' Severe 
X' 8 ' Error 
X * C ' Warning 

9 Variable information in the 

format shown below: 


2 bytes Statement number 
(if present) 

2 bytes Numeric parameter 
(if present) 

2 bytes Dictionary 

reference (if present) 

If text is to be inserted it is 
contained in a second dictionary entry 
immediately following the main entry for 
the message. The format of this second 
entry is: 


Byte Humber 
1 

2-3 

4 


5 


Code byte X'CB* 

Length 

Flag: X'OO' Text that 
follows has not been 
truncated and is 10 bytes 
or less 

X'01* Text that follows is 
not to be truncated and is 
greater than 10 bytes 
X* FF * Text that follows has 
been truncated and is to 
be printed within quotes. 
Variable length of text (in 
compiler internal code) . 


8 . DIMENSION TABLE 


Each entry containing dimension information 
will result in a table being set up. This 
table is shown in Figure 11. 


n multipliers 


| Code Byte C8 

j 

Two-byte length J Flag Byte 

t 

j Zero byte 

L 

| No. of dimensions (n) | Two-byte chain address 

1 

1 

j 


VIRTUAL ORIGIN WORD 

1 

^ 

1 

j 

r 

| One- byte marker 

■1 — — 
| Not 

used | Lower bound (halfword) 

I One-byte marker 

| Not 

used j Upper bound (halfword) 

1 

I 

1 

i 


-4— 

i 

1 

1 

| nth upper bound 

1 

1 


Note: The one-byte marker is: 

00 if bound is fixed point constant; bound is a two-byte binary constant, right-adjusted. 

FF if bound is an expression; bound is a three-byte pointer to a second file statement in 
text. 

7F if the bound is inherited and has an MTF function. 

3F if the bound is inherited and is covered by a previous MTF function. 

FO if the bound is specified by an *. 


Figure 11. Dimension Table 


9. DICTIONARY ENTRIES FOR INITIAL VALUES 


An INITIAL dictionary entry 


and 

The declaration of a variable with an 

INITIAL attribute produces these entries: One or more dictionary entries for 

constants 
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and perhaps 

A second File Statement for any iteration 
expression contained in the INITIAL 
specification. 

The INITIAL dictionary entry contains 
pointers to the constant entries and any 
Second File Statements, and is of the 
following format. 


The list contains the following code 
bytes to identify each associated 
dictionary reference: 


X'Fl* Constant iteration factor. This is 
followed by X'OO' and the dictionary 
reference of the constant iteration 
factor. 


Byte Number 


Description 


1 

2-3 

4 

5 

6 

7 onwards 
Final 


Code Byte X *C8* 

Length of entry 
Prefix options byte 
INITIAL code byte X *79* 
Left parenthesis 
INITIAL value list (see 
below) 

Right parenthesis 


INITIAL Value List 


X* F3* INITIAL value item. This is 

followed by X'OO' and the dictionary 
reference of the constant. (The BCD 
of the constant is expanded by any 
imposed string replication factor) . 


X'F5' EOB marker. This is followed by 

X'OO* and the dictionary reference 
of the next entry on the chain. 
(This will occur when the scratch 
core storage allocated for building 
the entry is not sufficient, and a 
chain of entries is constructed) . 


The INITIAL value list contains references X'F7' Variable iteration factor. This is 
to Second File Statements and dictionary followed by the text reference of 

entries which are created to correspond to the Second File Statement containing 

the value in the input text. the expression. 
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APPENDIX D; INTERNAL FORMATS OF TEXT 


This appendix describes the internal 
formats of text at various points during 
the compilation of a source program. The 
appendix is organized in the following 
manner: 

1. Text Code Bytes after the Read-In 
Phase 

2. Text Formats after the Read-In Phase 

3. Text Code Bytes on Entry to the 
Translator Phases 

4. Format of Triples 

5. Text Code Bytes in Pseudo-Code 

6. Text Formats in Pseudo-Code 


7. Text Formats in Absolute Code 


8. Second File Statements, and the 
Formats of Compiler Functions and 
Pseudo-Variabl es 

9. Pseudo-Code Phase Temporary Result 
Descriptors (TMPDs) 

10. Library Calling Sequences 

11. Descriptions of Terms and 
Abbreviations used in Text During a 
Compilation 

Note: The internal formats of text during 

compile-time processing are described 
in Appendix J. 
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1. TEXT CODE BYTE AFTER THE READ- IN PHASE 


First Level Table (00 to 7F) 


[ 0 j 8 j * j $ | BLANK | |j \ 


y ^ ^ 










I A 
I 




j_ B j K I S j * J | > + 


I c 


I D 


I E 


I F 


I G 


8 


I H 


I 


I 


SUBSCRIPT \ 

I 

* 

I 


J I 
I 


I* I 


M 


W 


P I 


| ASSIGN | MULTIPLE 
ASSIGN 


Q I 


-4 + + 

I i 




I II I 


-4 + 


R | Z 

f f | PSEUDO- | X * + 

j VARIABLE j 


I 


^ FUNCTION || ^ ^ 




I I 




DO 
EQUALS 


+ 


<= 


>= 

1< 


C*' 


■H 


REFER 


* 


PREFIX - ^ 


PREFIX ♦ 


t* 


| LITERAL 
j CONSTANT 

jr __ | < I ** ^ 


<-Digits-> | < Letters > | < Operators > 
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First Level Table (80 to FF) 


B 


T 

| HYBRID 
IQUAL 


TO 


ALLOCATE 


LINE 


CALL 


ENTRY 


+ 

SL 


SN 

ASSIGN BY 


NAME 


T 1 

FL DEC IMAG 


FL DEC REAL 


-H 

I 

-H 


2 

3 

4 

|5 

6 

7 

8 
9 

A 

B 

C 

D 

I* 

F 


BY 


FL BIN IMAG 


FREE 


RETURN 


1 PROC 

4~ 


SL' 


ON PROC 


FL BIN REAL 


WHILE 


| CHECK 

4~ 


CN 


FIX DEC IMAG 


DISPLAY 


GOOB 


BEGIN 


GET 


FIX DEC REAL 


SNAP 


COL 

SIGNAL 


R 


CL 


FIX BIN IMAG 


GO TO 


ITDO 


WRITE 


PUT 


END DO 


FIX BIN REAL 


SYSTEM 
WAIT 


y 4 4 


E 

REVERT 


y 4 + 


THEN 


DELAY 


{no 

I CHECK 
|DO 

+ 

j DATA 
| LIST DO 

-J 

INIT LABEL I IF 
+ 


2nd LEVEL 
MARKER 


4 4 


READ 


UNLOCK 




END ITDO 

4. 

END 


INTEGER 

-4 -I 

STG DEC REAL 
_4 ^ 


LOCATE 


REWRITE 


END PROG 


ON 


CONTROL 

VARIABLE 

y 

EXIT 


4 4 

NULL 


| SN2 

DECLARE I ELSE 


ARRAY 

CROSS SECTION 


4 4 


DELETE 


OPEN 


^END BLOCK 


CHAR CONSTANT 


y 


+ c {x {no SNAP 

ASSIGN j 1 FORMAT 


4 


iSUB 


STOP 


CLOSE 


BIT CONSTANT 
J. J 
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| FILE 


| LIST 


JUNE 


| EDIT 

TITLE | DATA 

ATTRIBUTES | STRING 
PAGESIZE | SKIP 


IDENT 


| LINES I ZE | PAGE 

[ | COPY 

flNTO jKEYTO 

| FROM |TASKOP 

| SET | 

| KEY | 

| NOLOCK IKEYFROM 

l | FORMAT 

| IGNORE j LIST 


| 


EVENT 1 j 
PRIORITY | 
REPLY | 




+— 


| DECIMAL 

4 

| BINARY 

4 

| FLOAT 

4 - 

j FIXED 


| REAL 
| COMPLEX 


| OPTIONS 

-1 

| IRREDUCIBLE 

| REDUCIBLE 

| RECURSIVE 

+ 

| ABNORMAL 2 

I NORMAL 2 


j PRECISION 1 | USES 2 

{PRECISION 2 | SETS 2 

| VARYING | ENTRY 

| PICTURE (NUM) {GENERIC 
{BIT ATTRIBUTE | BUILTIN 
{CHAR ATTRIBUTE { 

{DIMS (INTEGERS) | 

+ ] 

J LABEL j ORDER 

| | REORDER 

| DIMS | 

NAME | ( NON- INTEGER) j RETURNS 


EXTERNAL 


INTERNAL 


AUTOMATIC 


STATIC 


CONTROLLED 


SECONDARY 


INITVAR 1 


INITIAL 


DEFINED 


ALIGNED 


UNALIGNED 


PACKED 2 


AREA | 

4 

POINTER | 

•{ 

EVENT | 

4 

TASK j 

4 

CELL | 

1 

BASED | 


OFFSET j 

-I 

I 

-1 

I 

INITVAR 2 | 

4 




^ 

^ 

4 

1 

PICTURE j 

(CHAR) | 


*The EVENT built-in function and pseudo-variable are known externally by the 
equivalent name COMPLETION. 

2 Obsolete attribute. The second level marker is used only to ensure correct 
warning message transmission in Read-In, and does not appear in text at any time. 
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Second Level Table (80 to FF) 


8 9 ABCD EF 

0 
1 

2 

3 

4 

I 5 

6 

7 

8 
9 
A 
B 
C 
D 

I E 

F 


BUFFERED 


+— 


MAIN | 

+ +- 


T T T 

OVERFLOW | CONVERSION j CONDITION 

+ + -| * 


UNBUFFERED | 


4 

I 

| NAME 

H 


EXCLUSIVE 


REENTRANT I 


UNDERFLOW 


STRING- 

RANGE 


-+~ 


KEYED 


STREAM 




\i 

I- 

RECORD 

* i 

BACKWARDS 
SEQUENTIAL 

DIRECT | 

K ■}— 

PRINT 

K ■{— 

ENVIRONMENT j 

h +~ 

INPUT 
OUTPUT 

F +- 

UPDATE 

t 

I 

TRANSIENT j 
j. +- 


4 


SECONDARY I 


ZERODIVIDE 




TASK 


-+ 

I 

-+ 

FIXED 
OVERFLOW 


~| 

| TRANSMIT 

4 


AREA 
PENDING 


+— 


ENDFILE 


| CHECK 
4 






ON- BLOCK j 
+ +~ 


+ f 

SUBSCRIPT 
RANGE 




H 

I 

-H 


ON RECORD 








| 


I 


+ 

ERROR 


+ 

I 

+ 


END PAGE | 


•I 

I 

•I 


4 

I 

* 

I 

^ 


I 


FINISH 




+ +~ + 


+ + + 


SIZE 

+ 


| KEY 

I 

UNDEFINED 
FILE 


H 

I 

■■I ■i 

j NOCHECK 

4 ^ 

I 

4 ^ 

I 
I 

H -I 


2 . TEXT FORMATS AFTER THE READ-IN PHASE 


In the following statement formats the code 
bytes SN f SL, SL', POS f and OB have the 
following meanings: 

SN statement number 


SL statement label 


BIT 


ON CONDITION 


r 

1 o 

| OVERFLOW 

- —j 

| l 

| UNDERFLOW 


j 2 

| ZERODIVIDE 


1 3 

j FIXEDOVERFLOW 


1 ^ 

j SUBSCRIPTRANGE 


1 5 

| SIZE 


j 6 

j CONVERSION 


1 7 

j STRINGRANGE 


| 


— ___ J 


SL* initial label 

POS following SN is a 2 -byte statement 
number 

following SL is a 2 -byte 
dictionary reference of statement 
label or entry type 1 

OB prefix options byte, specifying ON 
conditions enabled for the 
statement as follows: 


The abbreviation SQUID means an 
identifier, possibly subscripted and/or 
qualified. 


PROCEDURE Statement 

The format of a PROCEDURE statement is as 
follows : 
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Attribute code - optional 
Attribute List - optional 


Byte Humber 


1 

2-3 

4 

5 


6 

7 

8-10 

11-13 

14-16 

17 

18... 


Description 

code byte SN or SL 

POS Statement terminating 

semicolon 

OB 

PROCEDURE 


Block level 
Block count 
PROCEDURE-BEGIN chain 
DECLARE chain 
ENTRY chain 

Left parenthesis - optional 

Format parameter list - 
optional 

Right parenthesis - optional 

Attribute marker - optional 

Attribute code - optional 

Attribute list - optional 

Statement terminating 
semicolon 


BEGIN Statement 


The format of a BEGIN statement is as 
follows : 

Byte Number Description 

1 Code byte SN or SL 


2-3 

4 

5 

6 
7 

8-10 

11-13 

14 


POS 

OB 

BEGIN 

Block level 

Block count 

PROCEDURE-BEGIN chain 

DECLARE chain 

Statement terminating 
semicolon 


ENTRY Statement 


END Statement 


The format of an ENTRY statement is as 
follows: 

Byte Number Description 

1 Code byte SN or SL 


2-3 POS 

4 OB 

5 ENTRY 


6-8 ENTRY chain 

9 Block level 

10 Block count 


The format of an END statement is as 
follows: 


Byte Number 
1 

2-3 

4 


Description 
Code byte SN or SL 
POS 
OB 


5 END1, END 2, or END 3 - END1 

ends a PROCEDURE or BEGIN 
block; END2 ends an 
iterative DO block; END 3 
ends a non-iterative DO 
block 


11 Left parenthesis - optional 

12... Formal parameter list - 

optional 

Right parenthesis - optional 
Attribute marker - optional 


6 

7 

8 


Block level for the 
containing block 

Block count for the 
containing block 

Statement terminating 
semicolon 
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IF Statement 



Statement terminating 
semicolon 

The format of 
follows: 

an IF statement is as 



Evte Number 

Description 

ON Statement 


1 

Code byte SN or SL 





The ON statement takes one of the following 

2-3 

POS 

formats : 


4 

OB 

1. 

Byte Number 

Description 

5 

IF 

1 

Code byte SN or SL 

6 • • « 

Expression 

2-3 

POS 


THEN 

4 

OB 


Statement or Group 

5 

ON 


ELSE - optional 

6 

ON Condition 


Statement or Group 
optional 

7 

SNAP or NOSNAP 

Note: The semicolon preceding the ELSE has 

8 

Statement or block 

been deleted 


2. 

Bvte Number 

Description 

DO Statement 


1 

Code byte SN or SL 



2-3 

POS 

The format of 

a DO statement is as follows: 

4 

OB 

Bvte Number 

Description 

5 

ON 

1 

Code byte SN or SL 

6 

ON Condition 

2-3 

POS 

7 

System 

4 

OB 

8 

SNAP or NOSNAP 

5 

DO or ITDO 



6 

CV 





ASSIGN Statement 

7 

BKC 



8... 

Squid 

The format of 
follows : 

the ASSIGN statement is as 


DO equals 

Byte Number 

Description 


Expression 

1 

Code byte SN or SL 


TO 

2-3 

POS 


Expression 

4 

OB 


BY 

5 

ASSIGN or ASSIGN BY NAME 


Expression 

6.. . 

Squid 


WHILE 


Comma - optional. 


Expression 


may be repeated 
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Squid - optional, 
may be repeated 

Variable number of bytes - 
optional, may be repeated 

ASSIGN 

Expression 

Statement terminating 
semicolon 

WAIT Statement 

The WAIT statement has the following 
format: 

Byte Number 

1 

2-3 

4 


CALL Statement 

The CALL statement has the following 
format: 

Byte Number 

1 

2-3 

4 

5 

6-8 

9 

10 
11 

12 . . . 


Description 

Code Byte SN or SL 

POS 

OB 


Description 

Code byte SN or SL 

POS 

OB 

CALL 

CALL chain 

Identifier 

Left parenthesis 

Expression 

Right parenthesis 

Left parenthesis 

Argument List 

Right parenthesis 

Statement terminating 
semicolon 


5 WAIT 


GO TO Statement 


6 

7... 


Left parenthesis 
Identifier 

Left parenthesis - optional 
Expression - optional 
Right parenthesis - optional 
Comma 

Further optional parentheses 
and expressions 

Right parenthesis 

Left parenthesis - optional 

Expression - optional 

Right parenthesis - optional 

Statement terminating 
semicolon 


The format of the GO TO statement is as 
follows: 

Byte Number Description 

1 Code byte SN or SL 

2-3 POS 


4 OB 

5 GO TO 


6 . . . Squid 


Statement terminating 
semicolon 
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SIGNAL and REVERT Statements 


4 


OB 


The SIGNAL and REVERT statements have the 
following format: 

Byte Number Description 

1 Code byte SN or SL 

2-3 POS 

4 OB 

5 SIGNAL or REVERT 

6 ON Condition 

7 Statement terminating 
semicolon 


5 DELAY 

6 Left parenthesis 

7... Expression 

Right parenthesis 

Statement terminating 
semicolon 


RETURN Statement 


DISPLAY Statement 


The format of the DISPLAY statement is as 
follows: 

Byte Number Description 

1 Code byte SN or SL 


4 

5 

6 


7. . 


POS 

OB 

DISPLAY 

Left parenthesis 

Expression 

Right parenthesis 

Left parenthesis - optional 

Squid - optional 

Right parenthesis - optional 

Statement terminating 
semicolon 


DELAY Statement 

The format of the DELAY statement is as 
follows: 

Byte Number Description 

1 Code byte SN or SL 


The format of the RETURN statement is as 
follows: 

Byte Number Description 

1 Code byte SN or SL 

2-3 POS 

4 OB 

5 RETURN 

6 Left parenthesis - optional 

7... Expression - optional 

Right parenthesis - optional 

Statement terminating 
semicolon 


STOP, EXIT, and Null Statements 


The format of STOP, EXIT and Null 
statements is as follows: 


Byte Number 
1 

2-3 

4 

5 

6 


Description 

Code byte SN or SL 

POS 

OB 

Statement identifier 

Statement terminating 
semicolon 
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INITIAL Label DECLARE Statements 


2-3 


POS 


The format of INITIAL label DECLARE 
statements is as follows: 

Byte Number Description 

1 Code byte SN or SL 


2-3 POS 

4 OB 

5 INITIAL Label DECLARE 


6-8 


DECLARE chain 


9... INITIAL label 

Statement terminating 
semicolon 


DECLARE and ALLOCATE Statements 


The format of DECLARE and ALLOCATE 
statements is as follows: 

Byte Number Description 

1 Code byte SN or SL 

2-3 POS 

4 OB 

5 DECLARE or ALLOCATE 

6-8 DECLARE chain or ALLOCATE 

chain 

9... Declaration list 

Statement terminating 
semicolon 


FORMAT Statements 

The format of the FORMAT statement is as 
follows: 

Byte Number Description 

1 Code byte SN or SL 


4 OB 

5 FORMAT 

6... Format list 

Statement terminating 
semicolon 

Format items are replaced by one-byte 
codes 


OPEN and CLOSE Statements 


The format of OPEN and CLOSE statements 
follows . 

Byte Number Description 

1 Code byte SN or SL 


2-3 

4 

5 

6 .. . 


POS 

OB 

OPEN or CLOSE 

File group list 

Statement terminating 
semicolon 


READ, WRITE. GET, PUT, REWRITE, UNLOCK, and 
DELETE Statements 


The format of READ, WRITE, GET, PUT, 
REWRITE, UNLOCK, and DELETE statements is 
as follows : 


Byte Number 
1 

2-3 


4 

5 

6 .. . 


Description 
Code byte SN or SL 
POS 
OB 

Statement identifier 

Option list 

Statement terminating 
semicolon 
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. TEXT CODE BYTES ON ENTRY TO THE 


TRANSLATOR PHASES 


COMPILER 

FUNCTION 


COMPILER 

FUNCTION 

CALL 


COMMA 


FCOMMA 


DO EQUALS 


COMPILER 

FUNCTION' 


COMPILER 
FUNCTION CALL' 


3 | | EDIT j EVENT 


TITLE 


PRIORITY 


COMPILER 

PSEUDOVAR 


COMPILER 

FUNCTION 

COMMA 


+ ^ 

| COMPILER | 

I PSEUDOVAR' I 


ATTRIBUTES 


PAGESIZE 


STRING 


REPLY 


STRING' 


ERROR 


COMPILER 

ASSIGN 


IDE NT 


LINESIZE 


BUY 

CHAMELEON 


BUY ASSIGN 


ASSIGN 


MULTIPLE 

ASSIGN 


^ 

OFS I 


KEYTO 


PSEUDOVAR 


BUYB 

CALSEQ 


-I 

I 

PSEUDOVAR ’ I 


LIST MARK 


END 

LIST MARK 


PREFIX - 


FUNCTION 


+- 


j FUNCTION* 

H 


ARGUMENT 

MARK 


PREFIX + 


NOLOCK 


KEYFROM 


DEFINED 

SUBSCRIPT 


SUBSCRIPT 


IGNORE 


FORMAT 

LIST 


| LITERAL | 
| CONSTANT j 

| FORMAT | 
I LIST* I 


DEFINED 

SUBSCRIPT 1 


SUBSCRIPT’ 
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89ABCD E F 

0 
1 
2 

3 

4 

5 

6 

7 

8 
9 
A 
B 

C 
D 
E 


F | STOP | ASSIGN |BUYS | FORMAT | {CLOSE | ; | FORMAT | 

l I A A L A A A J 


TO 


I LINE 


I* + 

j ALLOCATE | 

| BY | PAGE 

| FREE | 

| WHILE | SKIP 

j | DISPLAY 

F -1 

| SNAP | COL 

| | SIGNAL 

I- + 

j SYSTEM |E 

K 

j WAIT j REVERT 

| THEN | F 

| DELAY | 

I I 

|CV | 

| EXIT | NULL 

y + 

I .c 


+ H +— 


+ 


RETURN | PROC 

+ 

P I 

GOOB | BEGIN 

+ R I- + 


+ 


A I 

CALL 1 
B I 


+ 

BY' 


+ 


GOTO | ITDO 

I 

IDO 


+ 


|lF 

I 

SELL j SN2 
BUY | ELSE 
X | NOSNAP 


TO 1 


"T 

|SN 


1 


|sL 




WHILE' 

SORT 


j | | PROC* j 

f + + 1 

I CN |P* | | 

+ + + * 

|GET j | BEGIN* | 


SNAP’ 
WRITE 
SYSTEM* 
READ 


+ 


| CL 

+ 

j PUT 

+ 

E' 

^ 

{UNLOCK 

4 - 


+ 

LOCATED 

+ 


cv 

DELETE 


| F* 

+ 

REWRITE 

+ 

I 
I 




| OPEN 


H — 

|C* 

4 — 


CALL' 




END PROG 


END BLOCK 
END PROG 2 


EIO 


END DO | ITDO* 

— + + *1 

|END ITDO | j 

+ ^ 

END IDO* 

j 


^ 

IF* OR ON 

^ 

ARRAY 

CROSS SECTION 
1 ^ 


NOSNAP ' 


H 
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4. FORMAT OF TRIPLES 


The triples produced as output from the 
translator phase each consist of five 
bytes, an operator followed by two two- byte 
fields. Each of the two-byte fields may be 
occupied by an operand, which may be a 
dictionary reference, a code byte or code 
bytes, or a numeric parameter. Two zero 
bytes in place of a dictionary reference 
operand imply that the operand is the 
result of previous operations, and that its 
type and location are described in a TMPD 
in the text. 

The number of operands and the fields 
which they occupy depend upon the type of 
triple. The following table contains this 
information for all the triples used in the 
compiler. 


| TRIPLE TYPE 

I 

h 

| KEYED 


+ 


»- 

| TITLE 

h 

j ATTRIBUTES 

k- 

n 

h 


HEX 

CODE 

+ 

03 

+ 

04 


FIELD 1 


j FIELD 2 

I 

-4 4 

I - I 
■4 4 

I OPERAND 


05 


| OPERAND 


I PAGESIZE 


06 


I OPERAND 


J I DENT 

4 


07 


| OPERAND 

-+ 4 

| OPERAND 

-4 4 

| OPERAND 

-4 4 

j OPERAND 

-4 4 

| OPERAND 

-4 


| LINESIZE 

4 

| INTO 

h 


08 


0A 


FROM 


0B 


I KEY 


0D 


| IGNORE 

4 

j FILE 

4 


OF 


I OPERA ND 


10 


| OPERAND 

•4 4 


| LIST 

4 

j EDIT 

y- 


12 


-4 4 

I - I 
-4 4 


[DATA 


STRING 


y - 

\i 

| SKIP 

j. 

| LINE 

y 


13 

14 

15 


4 


I OPERAND 


16 


I OPERAND 


| PAGE 

y 

j COPY 

h 


17 

18 




OPERAND 

4 4 


I KEYTO 


19 

1A 


4 


4 4 

OPERAND 


-l_. 


I TASK 


T T 

IB 


| RPL 


1C 


-4 


IN 


ID 


OPERAND 


y 

| KEY FROM 




IE 


OPERAND 


I- 

j FORMAT LIST 


IF 


-4 


y- 

p 

y 

p 

y- 

p 

y- 

n 

y 

j PRIORITY 

4 

j REPLY 

| BUY CHAMELEON 
| MSA 
I MTA 


UP 


20 


OPERAND 


I GIVING 


21 


OPERAND 


-4 


[DOWN 


22 


OPERAND 


EVENT 


23 


OPERAND 


24 


-4 

I 

-4 


25 


27 

28 


4 4 

OPERAND 1 


OPERAND | 

4 

OPERAND | 

4 

OPERAND 21 


29 


OPERAND 1 


j DEFINED 
j SUBSCRIPT 

y- 


4 -- 


4 

OPERAND 2 | 

4 


2E 


OPERAND 


NULL-FUNCTION 
j. 

j COMPILER 
| FUNCTION 


2F 


— 4 
I 

-4 


30 


OPERAND 


y 

j COMPILER 
| FUNCTION CALL 


-4 


32 


OPERAND 


-4 


j COMPILER 
I PSEUDO- VARIABLE 


34 


OPERAND 


y 

| BUY ASSIGN 
I ARCO 


4 -- 


4 

OPERAND 2 j 

4 


37 


OPERAND 1 


38 


j fsUBO 
| PSEUDO- VARIABLE 
| [sSUB 


4 -- 


39 

3A 


4 


OPERAND 1 
OPERAND 


OPERAND 2 j 

4 


3B 


OPERAND 1 


OPERAND 2 


FUNCTION 


SSB 1 


y- 
n 
y- 

|p 

| SUBSCRIPT 
| NOP 
| [pTCH 
j COMMA 


3C 


OPERAND 


3D 


OPERAND 


-4 
• I 
-4 
I 

-4 


3E 


OPERAND 


>4 


3F 


40 

4 

41 


OPERAND 1 

4 


4 4 


OPERAND 2 | 

4 4 

* I 

j 


♦This triple may have two operands in 
format lists. 
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| FUNCTION COMMA | 4 2 

| COMPILER j 

j FUNCTION COMMA j 44 

| ACT | 45 

»■ + 

(COMPILER ASSIGN j 46 

I ASSIGN I 47 


| OPERAND | 
4 1 


(buy b 

y ~ 

| OR 

I AND 


| LIST* 

b 

I EDIT* 


CONCATENATE 


DATA* 


STRING' 


| STMPD 

y 

(multiple assign 

I 

| tmpd 

y 

| jmp 

f RPL * 


| LITERAL CONSTANT 
| FORMAT LIST* 

|up* 


| DO EQUALS 
| DOWN ■ 

I ERROR 


| UPSIDE-DOWN 
j COMMA 

y 

| LESS/EQUAL 


| GREATER/EQUAL 
| LEFT 

| NOT EQUAL 
| EQUAL 

{"greater 


+ 

| OPERAND 

I OPERAND 

+ 

I OPERAND 


+ 

I OPERAND 


+ 

| OPERAND 

| OPERAND 
+ 




| OPERAND 


l( OPERAND 2 j 
1 | OPERAND 2 | 

-+ -H 

1 | OPERAND 2 ( 


I OPERAND 


1 | OPERAND 2 | 

-+ 4 

j OPERAND j 

-4 — 4 

1 | OPERAND 2 ( 

~4 4 

1 | OPERAND 2 ( 

-4 4 

j OPERAND ( 

- 4 - 4 


| OPERAND 

| OPERAND 

| OPERAND 

| OPERAND 

4 - 


- 4 - 4 

lj OPERAND 2j 

- 4 * 4 

1 | OPERAND 2 j 
1 | OPERAND 2 | 

—4 4 

lj OPERAND 2 j 

-4 4 


4 - 


| OPERAND | 

- 4 - 4 




| OPERAND 




- 4 - 4 

lj OPERAND 2 ( 

I 1 

“+ 4 

I “ I 
- 4 - -4 


| OPERAND 

4 — 

| OPERAND 
| OPERAND 
| OPERAND 
| OPERAND 
| OPFRAND 
toPERAND 


1 | OPERAND 2 | 

- 4 - 4 

lj OPERAND 2 ( 
1 | OPERAND 2 | 

— 4 - 4 

1 | OPERAND 2j 

-- 4 - 4 

lj OPERAND 2j 

- 4 - 4 

lj OPERAND 2 ( 


1 | OPERAND 2 


| DIVIDE 
| OFS 

| MULTIPLY 


| PREFIX MINUS 
| FUNCTION* 

| PREFIX PLUS 


DEFINED 

SUBSCRIPT' 


COMPILER 

FUNCTION' 


COMPILER 
FUNCTION CALL' 


MINUS 


COMPILER 
PSEUDO- VARIABLE' 


PSEUDO- VARIABLE * 


| SUBSCRIPT' 

| EXPONENTIATE 

J. 

| TO 

J. 

I ALLOCATE 


y 

I FREE 


J WHILE 
I *CV 


DELAY 


END ALLOCATE 


| PAGE 
SKIP 


OPERAND 


OPERAND 


OPERAND 


OPERAND 


OPERAND 


OPERAND 


OPERAND 


OPERAND 


+ 4 

OPERAND j - | 

4. 4 

OPERAND lj OPERAND 2| 

4. 4 


OPERAND 


OPERAND 


| OPERAND | 

- 4 - 4 


OPERAND 


OPERAND 


OPERAND 


OPERAND 2 


4 

OPFRAND 21 


OPERAND 2 | 

4 

OPERAND | 

4 

OPERAND 21 


OPERAND 


OPERAND | - | 

4. 4 


OPERAND 2 


4. 4 


OPERAND 


- 4 - 4 

j OPERAND j 

- 4 - 4 


-4- 4 

| OPERAND | 

-4- 4 

j OPERAND | 

-f 4 

| OPERAND I 

-4- 4 

lj OPERAND 2j 

~+ 4 


OPERAND 


OPERAND 
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j DISPLAY 

h 


T T 

95 


f 


I COLUMN 


SIGNAL 


I REVEST 


h 
l £ 
h 

u 
Y- 
II 

Y 

|F 

Y 

|C 

Y 

|A 

I- 

j CALL 

I- 




[return 


— f 


[go out of block 


[go to 

|GOLN 

h 


A6 

+ + 

A7 

f + 

A8 


BUYT 

i 

| BUYX 

I- 

| BSFLL 
| SELL 
| BUY 

[x 


I* 

j BUYS 

|- 

|PROC 

| BEGIN 


1- 

| ITERATIVE DO 

Y 

IDO 


1- 

j IF 

|- 

| SN2 

I NOSNAP 


Y 

j FORMAT 

j. 

| TO* 


I- 

j BY* 

»■ 

j WHILE* 

L 


96 

97 


98 

99 
9A 


9E 

AO 


Al 


A2 

+ 

A3 


A4 

f 

A5 


A9 

+ + 


AA 

+ 

AB 

+ 

AC 


AD 

+ 

AE 

+ 

AF 

+ 

B3 

+ 

B5 


B7 

+ 

B9 


BB 

+ 

BC 

+ 

BE 


BF 


CO 


C2 

C4 


•T 1 

I OPERAND | 


| OPERAND | 

■— I 4 

| OPERAND j 

~+ 4 


4 4 

I OPERAND | 


| OPERAND | 

4 4 

| OPERAND | 




| OPERAND | 

— 4 4 

I OPERAND | 


4 -- 


| OPERAND | 

-+ 4 

j OPERAND j 

--+ 4 

j OPERAND j 

— -| 4 

j OPERAND j 

-4 4 

I OPERAND | 


OPERAND 

4- 


| OPERAND | 

+ 4 

j OPERAND 2 j 

-4 4 

1 1 OPERAND 2 j 

-4- 4 

j OPERAND j 

f 4 


-+ 


4— 


OPERAND | 

-4 4 

| OPERAND | 

4 4 


-4- 


4— 


| OPERAND | 

— 4 4 

j OPERAND | 

-+ 4 


OPERAND 

OPERAND 


| OPERAND | 

-4- 4 

I - I 
-4 4 


OPERAND 

4- 

| 


-4 4 

lj OPERAND 2 j 

-4- 4 

OPERAND | 

-4- 4 

j OPERAND 


| OPERAND | 

4 4 

j OPERAND j 
4 4 


OPERAND 


| OPERAND | 

4 

lj OPERAND 2 | 

._L J 


WRITE 


-4 Y- 


READ 

i 

|CV' 

| STATEMENT NUMBER 

»■ 

ICLN1 


-4 Y- 


J STATEMENT LABEL 

j. 

j j CLN2 

— 4 Y 


| COMPILER NUMBER 

Y 

| GET 


-4 Y- 


| COMPILER LABEL 
| PUT 


4 |. 


| E' 

Y 

j UNLOCK 

[ F * 

| REWRITE 
| OPEN 


4 j. 


|C* 

| CLOSE 

h 


1 CALL* 

Y 

|P* 

| END PROG 


| END BLOCK 


j END PROG 2 
| END I/O 


| PROC * 

Y 

j BEGIN* 

| ITERATIVE DO' 

h- 


-4 h 


| DO* 

| IF* OR ON 

h 

j PREFMT 


FORMAT* 


C7 | 


C9 


I 

H 


CC 

DO 

Dl 


| OPERAND 

4 

j OPERAND 

+ 


D2 


D3 


| OPERAND 
4 


D4 


D5 


D6 


- 4 - 4 

1 | OPERAND 2 | 

- 4 - 4 

lj OPERAND 2 | 

-+ 4 

| OPERAND | 

- 4 - 4 

lj OPERAND 2 I 

- 4 - 4 

j OPERAND j 

~+ 4 

| OPERAND j 

- 4 - 4 


D7 


4 ^ 

| OPERAND | 

4 4 

I - I 


D8 


D9 

4 

DA 

4- 

DB 
DD 


4— 

I 

+“ 

I 

4 ~ 


DE 

+ 

DF 


4 — 

I 

-4— 


-4- 4 

--+ 4 

-4- 4 

-4- 4 

--4- 


-4 


El 


E4 

4 

EB 


--4- 4 

I - I 
--+ 4 


-4 


-+ 


I - I 

4 - 4 

I 

4 - 4 


ED 


EE 

4 - 

FI 


-4 


F5 


F7 


4 + 

I - I - I 

I - I - I 

+ 1 

| OPERAND | 

+ 1 

| OPERAND j 

1 ^ 

I OPERAND | 


F3 | 


F9 


FB 

4 - 

FD 


FF 


+ 

I 

+ 

I 

I 


4 ^ 

| OPERAND j 

4 ^ 

| OPERAND j 
4 1 


-4 

I 

J 
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5 . TEXT CODE BYTES IN PSEUDO-CODE 


E F 
-T T 




l + 4 + 4 4 4 4 4 + 4 4 4 4 + __ 


2 

|DCV 2 

j ALLOC 

jpcc 

jBUYS 

j HER 

j LTR j ALR 

j SLDA j DCF 

j AH 

| AL 

| NI 

| MVN 

| PACK 

1 

1 


h 

-4 

-4 

.4 

-4 

-4 + 

•+ + 

- 4 — 

-4 

.4 

- 4 - — 

•4 

+- 

- 4 — 

3 

| DCV 3 

| DCA 3 

JCHSM 

j PINS 

j HDR 

j LTER j SLR 

SLDL I BCTA 

j SH 

j SL 

|OI 

| MVO 

|UNPK 

1 

1 


* 

■"j - — 

H 

.4 

-4 

.4 4 

.4 4 

.4 — 

-4 


- 4 - — 

-4 

+- 

- 4 — 

4 

| DCV 4 

| DCA 4 

j ADR 

j RWA 

|BCTR| LTDR| 

| SLL j BCT 

j MH 

| STC 

| SSM 

j MVZ 

| IGNORE | 

1 


DCVO | OSM 1 j BGPE | BLBS 


DCV 1 | OSM 2 |EOB |BLBS* 


LCR j LCDR j LCER j LM 


BCR | SPM | CLR | SLA 


BCTA ' j LH 


BC 


CH 


LA 


CL 


CLI 


MVI 


CLC 


MVC 


TR 


TRT 


INST 

4 4 

MVCL 


■H 

I 

H 


4 4 4 

DCV8 | FREE |SN 3 | APRM 

DROP | BUY | BCIN JUSNG 

4 -j ^ 

EQU | SELL jSTOP |EDIT 

PROC | PROC' jBGNP | FMT 
|LST 


NR |lNR |lPR jsRA ^ 

OR | LNER I LPER I SRDA 

^ 4 4 4 

XR | LNDR j LPDR j SRDL 

4 4 

LR | LDR | LER j SRL 


4 


4 




*begin}begin* 

PASS | ADV 
EOP | PLBS 
ECP 2 | PCBS 
IPRM jlPRM' 
EPRK | EPRM* 
ITDC | IT'DO* 


4 4 

j BGNP ' | FMT 

4 -) 

j DROB ' | FMT* 

4 4 

| PLBS' | EDIT* 

| PSLD | ERROR 

4 4— — 

| ABS |PFMT 

4 4 

| ABS ' | 

4 4 

j ALIGN j 
J x 


+- 


4 


4 4 4 4 

CR | CDR j CER j STM 

4 4 4 

AR jADR | AER j BXH 

-| 4 4 

SR j SDR | SER j BXLE 

MR |MDR | MER | SL 1 

1 + + + 

DR jDDR j DER j SN 

SVC | AWR | AUR | CLI 

i 4 i i 

BALRjSWR | SUR | CN 

J X X 


C 
A 
S 
M 
D 

4 -j 

|IC | 

4 4 


+- 
STH 

4 

QLA 

4 

| STD 

4 

| LD 

I 

4 

| CD 

4 

AD 


4 

ST 

4 

EX 

4 

STE 

4 

LE 

4 

CE 

4 

AE 


-4 


TM 
XI 
LA' 
DCF 2 




4 


4 4 4 

NC 

4 4 4 

OC I CONV 

4 4 4 

XC I CONV 


-4 + + +— 


ZAP 


USSL 


-4 4 4 4 — 


BCT’ 

MDRP 


CP 


DRPL 


-+ + + +— 


AP 


4 4 


4 4 


4 4 


1 

1 0 

1 CO 

H 

1 

1 

1 

1 

1 

1 K 

1 W 

H 

1 

4 

.4 

-4 

| SP 

X 

i MD 

K 

S 

— 

j SN 2 

(X 

32 

— 

Q 

D 

— 

m 

a 

H 

| OS M 3 

— 

O 

— 

> 

£ 

D 

<C 

— 

| EQU' 

|ed 

lL i CVB 

j CVD 

| BSW 

j EDMK 


CNVA 

SINL 

CNVC 1 

CNVC 2 
4 4. 

CNVC 3 

4 ~ + 

CNVC 4 


4 4 

I I 

4 4 

I I 

4 4 

I I 

4 4 

I I 

I I 

4 4 

I I 

4 4 

I I 

4 4 

I I 

4 4 

IGN 2 

4 4 

IGN 4 

4 4 

IGN 5 

4 4 

IGN8 


6. TEXT FORMATS IN PSEUDO-CODE 


The format of the various pseudo-code 
units is as follows: 


Pseudo-code Design 


Pseudo-code is essentially a symbolic 
representation of machine code, designed in 
such a way that it is possible to directly 
transform it into executable machine code 
by an assembly process. 


A unit consists of a one-byte operation 
code followed by, normally, a two or 
four-byte field and on the other occasions 
by a variable length field. The bit 
pattern of the operation code indicates the 
type of unit which it heads. 


Three- byte unit: this consists of a 
one-byte operation code followed by a 
two-byte literal offset, and it appears 
immediately after the symbolic 
representation of the instruction to 
which if refers. 


Five- byte unit: there are four basic 
five-byte units which have the 
following formats. 

Bytes 01 3 

r T T i 

j OP j 1 | R 2 | 

I I R1 I I 

| CODE | 0 | DICT REF j 

L X X J 


Bytes 0 1 3 

r T T 1 

By having most units either three or | OP | | | 

five bytes long, the scanning of j j R 3 | OFFSET | 

pseudo-code is a fairly straightforward j CODE | | I 

process. L l x - J 
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1 


3 


L R1,J0E(R3) 


Bytes 0 

r 


| Byte 0 


OP 

“T 

1 

1 

Rl 

~T 

1 

1 

R2 

CCDE 

j_ 

— 

1 

— J 

— 


1 


3 


OP 

“T ~ 

1 1 

1 

HEX 

— T — 
1 

1 

R2 

CODE 

1 0 


1 

DICT REF 


_x_ __ 


X_. 



Using these units with, if necessary, a 
three-byte unit, it is possible to 
symbolically represent any possible RR, RX, 
RS or SI instruction. 


Variable length unit: the format of 
this is: 

Bytes 01 3 

r 1 


| | FLAG | VARIABLE | 

[ CCDE 1 J_ J 


With a specially designed variable field 
described by a two-byte flag, it is 
possible to represent any SS instruction 
with this unit. 

The first byte of the two-byte flag 
indicates the format of the variable field 
and the second gives the length of the 
total unit. 


Bytes 0 
r 


DR (JOE) 


r t* 

| OSM2 j 
L X. 


L R1 , JOE+24 (R3) 
Bytes 0 1 


r 

1 L 

L _ 

1 

1 

O I 

1 1 

1 

h 1 

1 

Rl 

T 

1 

X 

j OSM3 

i 

24 

T' 

1 

L _ _ 



X 


DR (JOE) 


Alternatively, JOE might be a base 
register in which case the dictionary 
reference would be replaced by a symbolic 
register. The two forms are distinguished 
by setting the flag bit of the first 
symbolic register equal to one when a base 
register is intended. 


L R1,0(R3,R2) 

Bytes 0 1 

r T 

I L |1 


RX Instructions 

The following examples illustrate the basic 
forms of an RX instruction and the way in 
which they are represented in pseudo-code. 

L Rl , JOE 

| Bytes 0 1 3 

r T T 1 

j L | 0 Rl | DR ( JOE ) j 

I J X J 

L Rl, JOE+24 

| Bytes 0 1 3 

r ^ T 1 

j L j 0 Rl | DR (JOE) j 


When a branch instruction is generated 
which branches to a compiler generated EQU 
value, bit two of the second byte is set to 
one to indicate that the second field is in 
fact an EQU value. 


Bytes 0 
r* 


Bytes 0 

i" 


| BC 

I 

L 


T 1 

j EQU VALUE | 
-X J 


■T 1 

I *2 | 

j. 1 

| DICT REF | 

.X J 
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RS Instructions 


SI Instructions 


The following examples illustrate the basic 
forms of an RS instruction and the way in 
which they are represented in pseudo-codes 

BXH Rl,R2, ALPHA 

| Bytes 01 3 

f~ BXH | 0 R1 I DR (ALPHA) ] 

« J X J 

|~ OSK2 R2 ] 

l j J 


BXH Rl , R2 , ALPHA* 2 4 
| Bytes 01 3 


r BXH 

r ° 

Rl 

T“ 

1 

DR (ALPHA) ] 

j 


i OSM3 

— i — 

1 

24 

1 

X_ 

R2 | 


Alternatively, ALPHA might be a base 
register in which case the dictionary 
reference would be replaced by a symbolic 
register as in the RX instruction. 


SLA Rl, 6 

| Bytes 0 1 3 


I T T 1 

| SLA | Rl | 6 | 


RR Instructions 


The following example illustrates the form 
of an RR instruction and the way in which 
it is represented in pseudo- code. 


AR R1,R2 

J Bytes 01 3 

|” AR J” Rl | R2 ] 


The following examples illustrate the basic 
forms of an SI instruction and the way in 
which they are represented in pseudo-code: 

CLI BETA , X ' FF * 

| Bytes 0 1 3 

r t t 1 

j CLI jO FF j DR (BETA) j 
L X X J 


CLI BETA+4, X* FF* 

| Bytes 0 1 3 

r t t 1 

j CLI j 0 FF | DR (BETA) j 

L i x J 

f OSM1 J 4 ] 

L X J 


Alternatively, BETA might be a base 
register in which case the dictionary 
reference would be replaced by a symbolic 
register. 


SS Instructions 

Basically, an SS instruction consists of 
two base registers and a length byte. 

Since this does not conform to the format 
of other items of pseudo-code, it is 
necessary to represent an SS instruction 
with a variable length field, the length of 
which is specified in the second of two 
flag bytes immediately following the 
operation code. 


This variable form of pseudo-code will 
be used to convey items of information 
internally between compiler phases, at the 
same time maintaining the items in the 
guise of pseudo-code. 


Variable Length Item FLAG 

The first bit of the FLAG indicates whether 
or not the unit represents a machine 
instruction. In the former case, the 
format of the instruction is: 

| Bytes 

012 3468 10 

r T T T T T T T 1 

I OP | | I I I I I I 

j j FLAG | LENGTH j FI | F2 j F3 j F4 | F5 | 

| CODE] | I I I I I I 

L J X X X X X X J 
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The format of the FLAG is : 


ZAP 


ALPHA+3 (14) , BETA (6) 


Bit Zer o 

0 Always zero 

1 F2=dict. ref. 

2 F3=dict. ref. 

3 F4 not present 

4 F5 not present 

5-7 Not used 


One 

F2=sym reg. 
F3=sym reg. 
F4 present 
F5 present 


The FI field is identical to the length 
field in the SS machine instruction. The 
field contains one or two lengths which are 
each one less than the corresponding 
lengths used in Assembler Language. The F4 
and F5 fields contain literal offsets. 


| Bytes 01 23 4 

r T T T T 1 

| ZAP | X*10 ' j 10 j 13 5 j DR (ALPHA) I 
L J. x x x j 


— T - 
DR (BETA) | 

1 

3| 

j 


MVC 

ALPHA (6) 

, BETA+11 

i 1 2 

3 

4 

MVC j X ' 0 8 * j 

X_ _ X. 

10 j 5 

T ~ 1 

| DR (ALPHA) j 

_L 1 

i 8 



DR (BETA) 1 
_ X . 

l 

HI 

J 



AP ALPHA+3 (14) , BETA+11 (6) 


Compiler Function (Bit 1=1) 


In compiler functions, the format of the 
FLAG depends on the operation code. Thus: 


r t t r t 1 

| CONV j FLAG | LENGTH j Fl j F2 | 

L JL J X J. J 


The format of the FLAG is : 

Bits Both Zero Both One 

0 Always one 

1 and 2 Fl=dict. ref. F1=TMPD operand 

3 and 4 F2=dict. ref. F2=TMPD operand 
5-7 Not used 

The FLAG in the IGNORE item does not 
contain any information. 

The following examples illustrate the 
basic forms of an SS instruction and the 
ways in which they are represented in 
pseudo-code. 

MVC ALPHA ( 7 ) , BETA 

| Bytes 01 23 4 


jMVCjx'OO'j 8 j 6 
i x x x 

6 

[dr (BETA)] 
l j 


| DR (ALPHA) j 
-X J 


| Bytes 0 1 2 3 4 

[aP jx'18'j 12 J 13 5 JdR(ALPHA)] 
l x x x j j 

| 6 8 10 

r T T T 

| DR (BETA) I 3 I 11 1 
L X X J 


Alternatively, ALPHA and/or BETA might 
be base registers, in which cases, the 
dictionary references would be replaced by 
symbolic registers and the FLAG byte would 
be set accordingly: 

M70 ALPHA (14), 11(6, Rl) 

| Bytes 0 1 2 3 4 

[mVoIx' 28'T 10 |l3 5 ]dR (ALPHA)] 

L X X J J J 

| 6 8 

r t 

| Rl | Hi 

L X J 


Pseudo- code Format between IEMRA and IEMRF 


Fields that may hold a dictionary reference 
or register number have, at this time, the 
possibility of holding a literal offset. 

The presence of an offset is indicated by 
the first bit of the field being set to 
one, and earlier flags being set to 
' register. ' 
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7. TEXT FORMATS IN ABSOLUTE CODE 


SS Instructions 


Where a standard set of assigned registers 
is to be used for a section of code, e.g. 
in the construction of prologues, or during 
the generation of addressing instructions, 
it is possible to generate instructions 
with registers in absolute code, instead of 
the normal pseudo-code two-byte symbolic 
registers. (See "Text Formats in 
Pseudo-Code" in this Appendix. ) 


sections of absolute code are preceded 
by ABS markers and followed by ABS ' 
markers. The operation codes are the same 
as the normal pseudo-code instructions (see 
"Text Code Bytes in Pseudo-Code" in this 
Appendix) , but the instruction formats 
differ, as shown in the following examples: 


| Bytes 0 1 23 

r T T t 1 

j OP CODE | LENGTH | B1 | DICT REFCE | 

l X X X J 

I 5 6 

r — — t T 

| B2 j DICT REFCE | 

L X J 

I 0 1 

f OSMl”| OFFSET ] 

l X_^ J 

I 0 

| 0SM2 | OFFSET | 

i x ; j 


RS Instructions 


Shift Instructions 


| Bytes 

0 

1 


2 



j OP CODE 

”T * 

1 R1 

0 

"T" 

1 

OFFSET 


i_ 

-X 


-X. 



Other 

Instructions 





RR Instructions 1 Bytes 

0 

1 


2 



r 

j OP CODE 

i ri 

R2 

“T" 

1 

B2 


1 



-X. 



j Bytes 01 | 3 


|*~ OP CODE T R1 R2 ] \ DICT REFCE 1 


\ OSM2 J OFFSET ] 
L — X J 


SI Instructions 


RX Instructions 


| Bytes 0 12 

[” OP CODE J R1 X2 [ B2 


\ DICT REFCE ] 


\ OSM2 J OFFSET*] 



j Bytes 0 1 23 

f T T T 1 

j OP CODE | MASK | B1 | DICT REFCE | 

L X X X J 


\ OSM2 J OFFSET ] 

l X J 

Note that the OSM1/OSM2 markers and their 
following offsets are all optional; note 
also that the OSM2 byte does not have a 
register following it, as in normal 
pseudo- code, but a literal offset. 
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Array Bounds 


The first bit (bit 0) of the byte 
containing the base is used as a flag. If 
this bit is a one, the following two bytes 
contain, in their low order position, a 
twelve bit offset, instead of a dictionary 
reference. 


After Phases RA and RF all instructions 
in the text will be in absolute code. 


The format of the second file statement for 
array bounds is as follows: 

Byte Number Description 

1 Assignment statement marker 

2 Code Byte X’OO* 

3-4 ADV code X'0002' 


5 


Compiler pseudo-variable 


8. SECOND FILE STATEMENTS, AND THE FORMATS 6 

OF COMPILER FUNCTIONS AND PSEUDO-VARIABLES 

' ’ ~ ’ 7 


Left parenthesis 
Code byte X'00* 


Second File Statements 8-9 


Any expression occurring in an attribute 10 

must be put into a form which is acceptable 

to the translator phase. This means that 

it must look like a source statement. To 11 

comply with this, all expressions dealing 

with array bounds, strinq lengths, 12 

DEFINING, and INITIAL value iteration 

factors are converted into assignments to 13 

function references. These functions have 

a special meaning. They are not entered in 

the dictionary, and their dictionary 

references are to a region in the 14 

communications area. The pseudo-code 

physical phase dealing with each particular 

function generates in-line code instead of 15 

a function reference. 

16 


Dictionary reference of 
array 

Triple operator code byte 
X* 44 * 

Code byte X'5E* 

Code byte X'00' 

Code byte X'00' for lower 
bound, X * 01 ' for higher 
bound 

Number of the dimension 
whose bound is referenced 

Right parenthesis 

Triple operator code X*46* 


All the statements of this type are 
generated in the source text after the end 
of the original source program. They form 
a second program and are referred to later 
as the "second file." 


17... Expression for bounds 

Statement terminating 
semicolon 


The statements generated have the 
following overall format: 


Byte Number Description 
1 Code byte SN2 

2-3 Dictionary reference 

4 Options byte 

5 Statement type markers 


6 onwards Statement body 

The dictionary reference is the 
reference of a second file dictionary 
entry. This is described in Appendix C. 
The options byte is that for the options 
operative in a prologue, i.e. no 
interruptions are accepted. 


Multiplier Function 

Multiplier function statements are used to 
denote copying of a section of one dope 
vector into another. The format is: 

Byte Number Description 

1 Assignment statement marker 

2 Code byte X'00' 

3-4 MTF code bytes X'0010' 

5 Compiler call marker 

6 Left parenthesis 

7 Code byte X'00' 
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8-9 

Dictionary reference 

1 

10 

Triple operator code 
X ' 44 ' 

byte 

11 

Code byte X'00' 


12-13 

Dictionary reference 

2 

14 

Triple operator code 
X * 44 ' 

byte 

15 

Code byte X'5E' 


16 

Code byte X'00' 


17-18 

Offset 1 


19 

Triple operator code 

X ' 44 ' 

byte 

20 

Code byte X'5E' 


21 

Code byte X'00' 


22-23 

Offset 2 


24 

Triple operator code 
X * 44 ' 

byte 

25 

Code byte X'5E' 


26 

Code byte X'00' 


27-28 

Length 


29 

Right parenthesis 


30 

Statement terminating 
semicolon 


This statement requires the number of 
bytes specified by the length to be moved 
from the dope vector of the item at 
dictionary reference 2, starting at an 
offset of offset 2 , to the dope vector of 
the item at dictionary reference 1, 
starting at an offset of offset 1. 


6 Left parenthesis 


7 Code byte X'OO' 

8-9 Dictionary reference 

10 Right parenthesis 

11 Triple operator Code X*46' 

12... Expression 

Statement termination 
semicolon 

The dictionary reference is that of the 
item whose dope vector is being 
initialized. If the expression is defining 
the length of a string being returned by an 
internal function, then the dictionary 
reference is that of the entry type 2 
belonging to the label. In Figure 6 the 
reference is to B or C depending on whether 
the statement appeared in a PROCEDURE/ENTRY 
statement, or an ENTRY attribute. If the 
item is a data item, an external procedure, 
or a formal parameter entry point, then the 
dictionary reference of that particular 
item appears in the statement. 


INITIAL value statements 


INITIAL value statements are used to 
initialize a vector of storage used to 
contain iteration factors. It is implied 
that the value of the expression must be 
converted to type integer. The format is 
as follows : 


Byte Number Description 

1 Assignment statement marker 

2 Code byte X'00* 

3-4 IDV code 


String Length statement 


The string length statement is used to 
initialize the maximum length slot in a 
string dope vector. The format is: 

Byte Number Description 

1 Assignment statement marker 

2 Code byte X'00' 

3-4 SDV code X'0004' 

5 Compiler pseudo-variable 


5 

6 
7 

8-9 

10 

11 


12 . . . 


Compiler pseudo-variable 
Left parenthesis 
Code byte X'00' 

Dictionary reference 
Right parenthesis 
Triple operator code X*46' 
Expression 

Statement terminating 
semicolon 
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The dictionary reference is to the item 
being initialized. The integer is the 
number of assignment statements of this 
type, and for this variable, that have been 
generated before this one. 


9. PSEUDO-CODE PHASE TEMPOR TRY RESULT 
DESCRIPTORS (TMPD) 

Temporary Description Stack 


All information on temporary results is 
contained in this stack. Each item in the 
stack consists of 10 bytes. £ maximum of 
200 items is allowed. 

Second File Statements for BASED and OFFSET 


Byte 1 

A statement is generated for a variable 
which is declared BASED with its associated 
pointer given, and for a variable which is 
an OFFSET with its associated base given. 

The format of the statement is similar to 
that of the INITIAL value statement except: 

Byte 2 


Byte Number Description 

3-4 PEXP code (BASED) X'OOie' or 

BVEXP code (OFFSET) X'0017* 

12 Expression (which must be a 

single dictionary reference 
of the associated pointer or 
base) 


Flao 1 describes the addressing 
method contained in bytes 
5 through 10. 2 bits in 

this byte are also used 
during the release of 
temporary results 

Code 2 describes the radix, 

scale, mode, string type 
etc. of the temporary 
result. The format of 
this byte is identical to 
the similar byte in the 
dictionary and the DED 
used by the Library 
subroutines. routines. 
(See "Data Byte" in 
Appendix C.) 


The dictionary reference in bytes 8-9 is 
that of the BASED or OFFSET variable. 


Second File Statements for DEFINED 


Second file statements are generated when 
an expression is associated with DEFINED, 
but the expression does not contain any 
iSUEs. The format is: 

Byte Number Description 

1 Compiler assignment 
statement marker 

2 Code byte X'OO* 

3-4 ADF code; 

X * 0011 ' for base only 

X'0012* for subscripted base 
X'0013' for base with iSUB's 

5 Pseudo-variable marker 


Bytes 3-4 P, Q describes the precision 

and scaling of arithmetic 
type results 

Bytes 5-6 BASE in one of the following 
forms: 

1. "Reg by value" 
register containing 
the result - no index 
or offset is allowed. 

2. "Reg by value" 
register containing 
the base address of 
the result stack 

3. Offset from beginning 
of current temporary 
storage for results 
held in the temporary 
storage stack 

4. Dictionary reference 
which specifies the 
base address of the 
result of a subscript 
calculation 

Byte 7-8 NDX in one of the following 
forms : 


6 Left parenthesis 

Base7and subscript list 
Right parenthesis 
Statement terminating semicolon 


1. Symbolic indexing 
register for BASE type 
2 and 4. 

2. The number of bytes 
required in the 
temporary core stack 
for BASE type 1 
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Bytes 9-10 OFS 


which is a literal offset 
to be inserted in the 
base address. When used 
with BASE type 1 the 
actual temporary offset 
is the sum of the offsets 
and the number of bytes 
required in the stack is 
the sum of the contents 
Of OFS and NDX 

Strings are described in the following 
ways: 

If the string is of fixed length less 
than 256 bytes, it is given storage in 
the core stack. This type of string 
has a dictionary entry if it is passed 
to a subroutine. 

If the string is of variable length or 
longer than 256 bytes, the storage is 
bought and sold when required. This 
type of string always has a dictionary 
entry. 

If the string has no dictionary entry, 
it is described by the usual CODE 
bytes, the temporary core offset in 
BASE, and the byte length in NDX. 


If the string has a dictionary entry, 
it is described by the usual CODE bytes 
and the dictionary reference IN BASE. 
The dictionary entry describes the 
location of the strinq which may be 
either the temporary area offset and 
size for the first type, or a BUY 
statement for the second type. 


The 'top' of the stack is indicated by 
two pointers: PSTK and LSTK. PSTK points 
to the 'physical* top of the stack, which 
is the last item added. LSTK points to the 
'logical' top of the stack, which is the 
next item to be released. The difference 
is necessary because the temporary storage 
stack may not be released in the same order 
as the description stack. When an item in 
the description stack is released, the 
corresponding temporary storage may not be 
at the top of the stack storage. As the 
storage stack is always released in order, 
the description is flagged and the LSTK is 
reduced by 1 item. When the corresponding 
temporary core is released from the top of 
the storage stack, the description is 
completely removed from the 'physical* 
stack. 


j J f j Whether F7j 

j FLAG j F5 j F6 j applicable! 

r t 

|X'00' (Dictionary 

i — j 

Yes 

T 

j (reference 

1 1 



j X ' 02 * j Dictionary 


No 


j (reference 

1 1 



(X'04* (Dictionary 


No 


j (reference 

1 1 



|X*05* (Dictionary 

(Dictionary | 

No 


j (reference* 

j reference 2 j 



jx* 20' (Dictionary 

(Index j 

Yes 


j (reference 

J register | 



j X ' 41 * j Symbolic 

(Dictionary j 

Yes 


J j register 

j reference j 



|X'49* j Symbolic 

(Dictionary ( 

Yes 


( ( register 

j reference ( 



j X* 80 ' (Register 

1 - | 

No 


(X'CO* (Workspace 

1 - | 

Yes 


| (offset 

1 1 



jx'Cl* (Workspace 

(Dictionary | 

Yes 


j j offset 

(reference | 



j X'C5* (Workspace 

(Dictionary j 

No 


| (offset 

j reference j 


X 


Comments 


1 


STRUT 2 output — must SELL dictionary ref. 
REPEAT function result. 

SUBSTR function result. 

Arithmetic subscript, or SDV for varying 
string subscript. 

Non-ad justable fixed string subscript, with 
DROP in STRUT 2 . 

Non-adjustable fixed string subscript, without 
DROP in STRUT2. 

Item in register — F7 cannot exist. 

SDV for adjustable fixed string subscript. 
SUBSTR pseudo- variable result. 

Notes 1. Since F6 cannot be used for both an index register and a dictionary 
reference, bits 2 and 7 of the FLAG byte cannot both be 1. 

2. Many other bit configurations in the FLAG byte are meaningful and could 
be used for future applications. 

Figure 12. Temporary Descriptions in Pseudo-Code — Use of TMPD Triple Fields F5 and F6 
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Temporary Descriptions in Pseudo-Code 


Descriptions are passed between pseudo- code 
phases using two or three TMPD triples, 
with the following formats: 

r T T T T 1 

j TMPD I FLAG I F2 | F3 | F4 | 

K + A i x 1 

j TMPD j F5 j F6 | 

F + + 1 

j TMPD j F7 j j 

L L A 1 


1. FLAG describes the use of fields F5, 
F6, and F7. 


3. F3 and F4 contain: 

a. Precision and scale factor of 
coded arithmetic type data 

b. String length for coded 
non-ad justable strings (maximum 
length for varying strings) 

c. Picture dictionary reference for 
data with picture 


4. F5 and F6 are at present used as shown 
in Figure 12. 


5. F7 can be used by adding X'10' to the 
FLAG byte in all cases which give a 
meaningful result (see Figure 12). 


— T 


Bit 

Number 


Value 


Meaning 


0 and 1 


00 

11 

01 

10 

0 

1 

0 

1 


F5 contains a dictionary 
reference 

F5 contains a temporary 
workspace offset 
F5 contains symbolic 
register with address of 
item 

F5 contains register with 
value of item 
F6 does not contain index 
register 

F6 contains index register 
Two TMPD triples are used 
Three TMPD triples are 
used, and F7 contains an 
offset 

Normal setting. String 
utility STRUT2 drops 
symbolic register in F5 if 
used for input 
String utility STRUT2 does 
not drop symbolic register 
Normal setting 
Result of an invocation of 
SUBSTR or REPEAT 
No SELL is required 
User of this description 
must SELL dictionary 
reference in F5. Set by 
string utilities for 
adjustable string result 
F6 does not contain a 
dictionary reference 
F6 contains a dictionary 
reference 


10. LIBRARY CALLING SEQUENCES 


Internal library routines are used for such 
things as data type conversion, where there 
is no explicit reference to the routine in 
the PL/I source program. The arguments are 
handed to the routines in registers. In 
pseudo- code form, assigned registers are 
used, and special markers, IPRM and IPRM* 
are used to indicate the calling sequence 
to the register allocator phase. Internal 
library calls appear in pseudo-code as: 


IPRM 


L 

1, (ARGUMENT1) 

L 

2, (ARGUMENT2) 

L 

15 , IHE (Routine Name) 

BALR 

14,15 

IPRM' 



The second byte of the IPRM item is used 
as a flag byte. The settings are as 
follows : 


Bit 0 Must be zero 

Bit 1 END, or RETURN statement not 

in BEGIN block calling 
sequence 


2. CODE contains the data byte 

(describing type, radix, scale, mode, 
etc. ) 


Bit 2 END statement calling 

sequence 
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ADV 


External library routines calls 
correspond to explicit references to 
functions or I/O statements in the PL/ I 
source program. The arguments to the 
routines are placed in workspace, and 
register 1 is set to point to the first 
argument. For pseudo-code form the calling 
sequence is preceded by an EPRM marker and 
followed by an EPRM' marker. Thus, the 
library calling sequence appears as: 

MVC WSP (N) , ( ARGUMENTl ) 


EPRM 1,WSP 

L 15, 1 HE (Routine Name) ALIGN 

BALR 14,15 

EPRM* 

LA 1,WSP 

The second byte of the EPRM is used as a ALLOCATE 
flag byte. The setting is as follows: 

Bit 0 A calling sequence to a PL/I APRM 

procedure 


PS 


PS 


R,T,PS 


PS 


11. DESCRIPTIONS OF TERMS AND 

ABBREVIATIONS USED IN TEXT DURING A ARCO T,PS 

COMPILATION 


The table in this section gives first, the 

term or abbreviation; second, the phase in AREA R 

which the term is used; and third, a brief 

description of the meaning of the term or ARGUMENT MARK R 
abbreviation. The key to the code used is: 

R After the Read-In Phase 
PS During the Pseudo-Code Phase 


T 

A triple or translator input 

ARRAY CROSS 

R, T 


code byte 


SECTION 


Term or 

Used In 




Abbreviation Phase 

Description 

ASSIGN 

R,T 

A 

R, T 

Character string 
format item 

ASSIGN BYNAME 

R 

ABS 

PS 

Indicates the start 
of absolute code 
(Appendix D7) 



ABS* 

PS 

Indicates the end of 
absolute code 

ATTRIBUTES 

R,T 

ADI 

PS 

Addressing 
instruction (used 





between phases RA and 
RF) 



ADR 

PS 

The two byte operand 
contains a register 

AUTOMATIC 

R 



for use by final 
assembly for 
addressing branch 

B 

R,T 



destinations beyond 
4096 bytes from the 
program base 

BACKWARDS 

R 


Used in 2nd file 
assignment statements 
to indicate that the 
expression has been 
calculated and that 
the following code is 
only concerned with 
assignment to the 
variable, or its dope 
vector, which is the 
subject of the second 
file statement 


Indicates that 4 byte 
alignment is required 
in the code at this 
point 

Replaces the keyword 
ALLOCATE 

Indicates the library 
calling sequence for 
VDA or controlled 
storage 

Provides space to 
allow insertion of 
argument conversion 
triple 

Replaces keyword AREA 

Marker used by phases 
GK and GP to indicate 
he start of a 
function argument 

Replaces the PL/I *♦' 
used to specify an 
array cross section 

Marker which precedes 
an assignment 
statement 

Precedes an 
assignment statement 
with the BY NAME 
option 

Marker which precedes 
a dictionary entry 
containing the 
attributes which have 
been specified on an 
OPEN or CLOSE 
statement 

Replaces the keyword 
AUTOMATIC 

Bit string format 
item 

Replaces keyword 
BACKWARDS BEGIN 


Appendix D: Internal Formats of Text 439 



BASED 


BEGIN* 

BGPE 

BGNP 

BGNP* 

BIT ATTRIBUTE 

BIT CONST 

BINARY 

BLBS 

BLBS* 

BUFFERED 

BUILTIN 

BUY 

BUY 

ASSIGNMENT 

BUYB 

BUY CHAMELEON 


R Replaces keyword 

BASED 


T f PS 


PS 


PS 


PS 


R 

R 

R 


Triple which 
terminates the BEGIN 
block triples 

Indicates the end of 
the complete prologue 
for a begin block 

Indicates the start BUYS 
of code for a BEGIN 
block with no 
prologue 

Indicates the end of 
code for a begin 
block with no 
prologue 

BY 

Replaces the keyword 
BIT 

BY* 

Marker preceding a 
BIT string constant 

Replaces the keyword BY NAME 
BINARY 


PS 


PS 


R 


Indicates the start C 
of the prologue for a 
BEGIN block 

C* 

Indicates the end of 
the prologue for a 
BEGIN block 

CALL 

Replaces keyword 

BUFFERED CALL' 


R Replaces the keyword 

BUILTIN 


indicates that 
workspace is required 
for a temporary 
variable of chameleon 
data type i.e. the 
data type is taken 
from the expression 
assigned to the 
variable 


T,PS Code byte or triple 
which indicates that 
a temporary variable 
is required, and that 
initialization code 
exists between this 
triple and the BUY 
triple 

R r T Replaces the keyword 

BY 

T Triple which 

indicates the end of 
a BY expression 

R Replaces the keyword 

BY NAME 

R,T Complex decimal 

format item 

T Triple which 

indicates the end of 
a C format item 

R, T CALL statement marker 

T Triple internal to 

phase IA which marks 
the end of a CALL 
statement 


T, PS 


T 


T 


Code byte or triple 
which indicates that 
a temporary variable 
is required 

Triple which indi- 
cates assignment to a 
temporary variable, 
and which implies 
that the workspace 
for the temporary 
variable must be 
obtained before the 
assignment 

Triple or code byte 
which indicates that 
a scalar temporary is 
required for an 
aggregate argument to 
a generic scalar 
built in function 


CELL R 

CHAR R 

ATTRIBUTE 

CHAR CONSTANT R 

CHECK R 

CHSM PS 

CL R,T,PS 

T 


Replaces the keyword 
CELL 

Replaces the keyword 
CHARACTER 

Marker preceding a 
character string 
constant 

Replaces the keyword 
CHECK 

A special offset 
marker. Used only in 
absolute code to 
indicate that the 
offset may require 
changing 

Compiler label marker 

Compiler label number 
triple, referred to 
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Marker which 


CLN1 





once only in the 
current statement 

CLN2 

T 

Compiler label number 
triple, referred to 
at any point 

CLOSE 

R f T 

Replaces the keyword 
CLOSE 

CN 

R,T,PS 

Compiler statement 
number. Can precede 
compiler inserted 
statements 

CNVC1, — 4 

PS 

Convert compiler 
functions 

l=Drop all registers 
2=Drop target 
register 

3=Drop source 
register 

4=Do not drop 
register 

COL 

R,T 

Replaces the keyword 
COLUMN 

COMA 

T 

Triple indicating an 
individual subscript 
in a subscript list 

COMPLEX 

R 

Replaces the keyword 
COMPLEX 

COMPILER 

ASSIGN 

T 

Code byte or triple 
indicating assignment 

COMPILER 

FUNCTION 

T 

Code byte or triple 
used to indicate the 
start of a compiler 
function call 
argument list 

COMPILER 

FUNCTION' 

T 

Triple indicating the 
end of a compiler 
function argument 
list 

COMPILER 

FUNCTION 

T 

CALL 

Code byte or triple 
used to indicate the 
start of a compiler 
function call 
argument list 

COMPILER 

FUNCTION 

T 

CALL* 

Triple indicating the 
end of a compiler 
function call 
argument list 

COMPILER 

FUNCTION 

T 

COMMA 

Triple used to indi- 
cate the argument of 
compiler function, or 
Pseudo-Variable 


COMPILER T 

PSEUDO- VARIABLE ' 

Triple indicating the 
end of a compiler 
pseudo- variable 
argument list 

COMPILER T 

PSEUDO-VARIABLE 

Code byte or triple 
used to indicate the 
start of a compiler 
pseudo- variable 
argument list 

COMR 

T 

Triple indicating an 
individual subscript 
held in a register 

CONDITION 

R 

Replaces the keyword 
CONDITION 

CONTROLLED 

R 

Replaces the keyword 
CONTROLLED 

CONTROL 

VARIABLE 

R,T 

Marker which indi- 
cates the control 
variable of a DO loop 

CONVERSION 

R 

Replaces the keyword 
CONVERSION 

COPY 

R,T 

Replaces the keyword 
COPY 

CONTROL 
VARIABLE ' 

T 

Triple which indi- 
cates the end of a 
control variable 
expression 

DATA 

R,T 

Replaces the keyword 
DATA 

DATA' 

T 

Triple indicating the 
end of a data 
directed I/O list 

DATA LIST DO 

R 

Replaces the keyword 
DO in an iterative 
clause in a data list 

DCF2 

PS 

Causes output of 
'ERROR STOP' and the 
four bytes following 
in the pseudo-code 
item 

DECIMAL 

R 

Replaces the keyword 
DECIMAL 

DECLARE 

R 

Replaces the keyword 
DECLARE 

DEFINED 

R 

Replaces the keyword 
DEFINED 

DEFINED 

SUBSCRIPT 

T 

Marker which precedes 
the parenthesized 


iSUB subscript list 
of a defined array 
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DELAY 

R,T 

Replaces the keyword 
DELAY 

ELSE 

R, T 

DELETE 

R, T 

Replaces the keyword 
DELETE 

END 

R, T 

DICTIONARY 

T 

Marker indicating 



REFERENCE 


that the following 
two bytes contain a 
symbolic dictionary 
reference 

END BLOCK 

R,T, 

DIRECT 

R 

Replaces the keyword 
DIRECT 

END DO 

R,T 

DISPLAY 

R 

Replaces the keyword 
DISPLAY 

ENDFILE 

R 

DO 

R,T 

Replaces the keyword 

DO , in a 

non-iterative DO 

END ITDO 

R , T 



group 



DO EQUALS 

R, T 

Marker which replaces 
the PL/I * = * in the 

END LIST MARK 

R 



iterative DO 
statement (DO 1= ) 



DROB 

PS 

Indicates to the 
register allocation 

END PROG 

R,T,] 



phases that a base 
register used for 
addressing a 
controlled variable 

END PR0GRAM2 

T, PS 



should be dropped 



DROP 

T 

Triple used in 
optimization 
indicating the drop 
of an index register 



DROP 

PS 

Indicates that a 
symbolic or assigned 

ENTRY 

R 



register in the 
operand field of the 
instruction is no 
longer required 

EPRM 

PS 

DRPL 

PS 

Indicates the end of 
the use of a list of 





symbolic registers 
which have appeared 
in an USSL item 

EPRM' 

PS 

E 

R, T 

Floating decimal 
format item 

EQU 

PS 

EDIT 

R, T 

Replaces the keyword 
EDIT 



EDIT* 

T 

Triple indicating the 
end of an edit 
directed I/O list 

EQU* 

PS 

EIO 

T 

Code byte or triple 




which indicates the 
end of an I/O 
statement 


442 


Replaces the keyword 
ELSE 


Replaces the END 
keyword at the end of 
a BEGIN or PROCEDURE 
block 

Indicates the end of 
a text block 

Replaces the END 
keyword at the end of 
a non-iterative DO 
group 

Replaces the keyword 
ENDFILE 

Replaces the END 
keyword at the end of 
an iterative DO loop 

Marker used by phases 
GK and GP to indicate 
the end of a function 
argument list 

Marks the end of 
program 

Triple which marks 
the end of the second 
file text i.e. 
prologue 

initialization text, 
which is placed after 
the source program 
text 

Replaces the keyword 
ENTRY 

Indicates the start 
of an external 
library calling 
sequence. (Appendix 
DIO) 

Indicates the end of 
an external library 
calling sequence 

Indicates that the 
two byte operand 
field contains a 
label. The label is 
considered to be 
attached to the 
following pseudo-code 
item 

As for EQU, but 
indicates that 
control may enter 
from a different 
statement. 



ERROR 


R 


ERROR T 


ERROR PS 

EVENT R, T 

EXCLUSIVE R 

EXIT R,T 

EXTERNAL R 

F R f T 

F* T 

F COMMA T 


FILE R f T 

FILE T 

FINISH R 

FIXED R 

FIX BINARY R 

IMAGINARY 

FIX BINARY R 

REAL 


FIX DECIMAL R 
IMAGINARY 


FIX DECIMAL R 
REAL 


Replaces the keyword 

FIXED 

R 

Replaces keywords 

ERROR 

OVERFLOW 


FIXED OVERFLOW 

Code byte or triple 
which marks the 

FLOAT 

R 

Replaces the keyword 
FLOAT 

position of an 

FLOAT BINARY 

R 

Marker which precedes 

erroneous source 
statement which has 
been deleted 

IMAGINARY 


a float binary 
imaginary constant 

Indicates the 
presence of a source 

FLOAT BINARY 
REAL 

R 

Marker which precedes 
a float binary real 
constant 

program error 

FLOAT DECIMAL 
IMAGINARY 

R 

Marker which precedes 
a float decimal 

Replaces the keyword 
EVENT 



imaginary constant 


FLOAT DECIMAL 

R 

Marker which precedes 

Replaces keyword 
EXCLUSIVE 

REAL 


a float decimal real 
constant 

Replaces the keyword 
EXIT 

FORMAT 

R, T 

Replaces the keyword 
FORMAT 

Replaces the keyword 
EXTERNAL 

Fixed decimal format 

FORMAT* 

T 

Triple which marks 
the end of a remote 
format statement 

item 

Triple which 

FORMAT LIST 

Rf T 

Precedes a format 
list 

indicates the end of 
an F format item 

FORMAT LIST* 

T 

Triple indicating the 
end of a format list 

Triple used to 
indicate the 
arguments of a 

FREE 

Rf T r PS 

Replaces the keyword 
FREE 

function or pseudo 
variable 

FROM 

R,T 

Replaces the keyword 
FROM 

Replaces the keyword 
FILE 

Triple indicating the 
end of a file list 

FUNCTION 

T 

Code byte or triple 
indicating the start 
of a function 
argument list 

Replaces keyword 

FINISH 

Replaces the keyword 
FIXED 

Marker which precedes 

FUNCTION 

R 

Marker which precedes 
the parenthesized 
argument list (if 
present) of an entry 
name in a function 
reference or CALL 
statement 

a fixed binary 
imaginary constant 

GENERIC 

R 

Replaces the keyword 
GENERIC 

Marker which precedes 
a fixed binary real 
constant 

GET 

R,T 

Replaces the keyword 
GET 

Marker which precedes 
a fixed decimal 

GOOB 

Rf T 

GOTO out of block 
statement marker 

imaginary constant 

Marker which precedes 

GOLN 

T 

Indicates a branch to 
a label number 

a fixed decimal real 
constant . 

GOTO 

R, T 

GOTO in block 
statement marker 


Appendix D: Internal Formats of Text 443 



IDENT 

R,T 

Replaces the keyword 
IDENT 

IF 

R,T 

Replaces the keyword 
IF 

IF 1 

T 

Triple which 
terminates an IF 
expression 

IGN 2.. 8 


Ignore markers used 
by Final Assembly 
when code has been 
made redundant. The 
final digit indicates 
length to be ignored. 

IGNORE 

R, T 

Replaces the keyword 
IGNORE 

IGNORE 

PS 

Pseudo-code item 
which indicates that 
the number of bytes 
appearing in the 
length count must be 
ignored 

IN 

R/T 

Replaces the keyword 
IN 

INITIAL 

R 

Replaces the keyword 
INITIAL 

INITIAL LABEL 

R 

Marker which precedes 
elements of arrays of 
labelvariables which 
are initialized by 
being attached to 
statements 

INITVAR 

R 

Replaces the keyword 
INITIAL ( iteration 
factors) 

INPUT 

R 

Replaces keyword 

INPUT 

INST 

PC 

Defines a store 
generated by register 
allocator which may 
be deleted by phase 

TF if unused 

INTEGER 

R 

Marker which precedes 
an internal binary 
integer constant 

INTERNAL 

R 

Replaces the keyword 
INTERNAL 

INTO 

R,T 

Replaces the keyword 
INTO 

IPRW 

PS 

Indicates the end of 
an internal library 
calling sequence 

ITDO 

R,T,PS 

Replaces the keyword 




DO in an iterative DO 
loop 

ITDO' 

T # PS 

Triple which 
terminates an 
iterative DO 
expression 

JMP 

T 

Triple indicate the 
presence of 
pseudo-code. The 
number of bytes of 
pseudo-code is 
specified in the 
first operand 

KEY 

R,T 

Replaces the keyword 
KEY 

KEYED 

R 

Replaces keyword 

KEYED 

KEYFROM 

R,T 

Replaces the keyword 
KEYFROM 

KEYTO 

R, T 

Replaces the keyword 
KEYTO 

LABEL 

R 

Replaces the keyword 
LABEL 

LEFT 

T 

Triple indicating a 
temporary result for 
a pseudo- variable 

LIKE 

R 

Replaces the keyword 
LIKE 

LINE 

R,T 

Replaces the keyword 
LINE 

LINESIZE 

R,T 

Replaces the keyword 
LINESIZE 

LIST 

R/T 

Replaces the keyword 
LIST 

LIST' 

T 

Triple indicating the 
end of a list 
directed I/O list 

LIST MARK 

T 

Marker used by Phases 
GK and GP to indicate 
the start of function 
argument list 

LITERAL 

CONSTANT 

R,T 

Indicates that the 
following two bytes 
contain a fixed 
binary constant 

LOCATE 

R,T 

Replaces the keyword 
LOCATE 

MAIN 

R 

Replaces keyword MAIN 

MDRP 

PC 

Defines a register 
which will be 
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multiply dropped. 

Phase RA no-ops all 
DROP'S for this 





reqister except the 
last 

OSM3 

PS 

MULTIPLE 

R # T 

Marker indicating 



ASSIGN 


multiple assignment 
(Replaces PL/I*,') 

OUTPUT 

R 

MVCL 

PC 

Defines a character 





move greater than 256 





bytes. This is 
expanded by phase QF 

OVERFLOW 

R 

NAME 

R 

Replaces the keyword 

P 

AR # T 



NAME in the context 
of ON NAME 

P' 

T 

NEW PAGE 

R 

Replaces the keyword 
NEW PAGE 

PAGE 

R f T 

NOCRECK 

R 

Replaces the keyword 
NOCHECK 

PAGESIZE 

R,T 

NO SNAP 

R f T 

Replaces the keyword 
NOSNAP 

PASS 

PS 

NOS NAP* 

T 

Triple which 
indicates the end of 
a NOSNAP list 

PCBS 

PS 

NULL 

R,T 

Null statement marker 

PCC 

PS 

NULL- FUNCTION 

T 

Enables TMPD's to be 
passed in text by 
phases LB and LG 
before the evaluation 
phase LS 

PFMT 

PS 

OFFSET 

R 

Replaces the keyword 
OFFSET 

PICTURE 

R 

OP£ N 

R,T 

Replaces the keyword 
OPEN 

PINS 

PS 

OFS 

T 

Triple indicating 
offset used in 
optimization of DO 
loops 

PLBS 

PS 

ON 

R,T 

Replaces the keyword 

ON 

PLBS * 

PS 

OPTIONS 

P. 

Replaces the keyword 
OPTIONS 



ON RECORD 

R 

Replaces the keyword 
R’-.CORIj in the context 





ON RECORD 

POINTER 

R 

OSK1 

PS 

Indicates that the 
two byte operand 
field contains an 
index register 

PRECISION! 

R 

OSM2 

PS 

Indicates that the 




two byte operand 
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field contains a 
leteral offset 


Indicates the 
presence of a literal 
offset and an index 
register 

Replaces keyword 
OUTPUT 

Replaces keyword 
OVERFLOW 

Picture format item 

Triple which 
indicates the end of 
a P format item 

Picture format item 

Replaces the keyword 
PAGESIZE 

POINTER Assignment 

Indicates the end of 
the complete prologue 
for a procedure block 

Follows a PPOC or 
BEGIN marker. Used 
to carry the prefix 
change byte for the 
block. 

PICTURE format 

Replaces the keyword 
PICTURE 

Indicates the 
prologue insertion 
point 

Indicates the start 
of the prologue for a 
procedure block which 
is common to all 
entry points 

Indicates the end of 
the prologue of a 
procedure block which 
is common to all 
entry points 

Replaces the keyword 
POINTER 

Indicates a precision 
which has been 
written in the source 
program as * (10 ) * , 
which may be either 
fixed or float 


Formats of Text 445 



PRECISI0N2 

R 

Indicates a precision 
which has been 
written in the source 
program as *(5,2)* 
which implies fixed 

PRINT 

R 

Replaces keyword 

PRINT 

PRIORITY 

R # T 

Replaces the keyword 
PRIORITY 

PSEUDO- 

VARIABLE 

R 

Marker which precedes 
the parenthesized 
argument list to a 
pseudo-variable 

PSEUDO- 

VARIABLE 

T 

Code byte or triple 
indicating the start 
of a pseudo- variable 
argument list 

PSEUDO- 

VARIABLE* 

T 

Triple indicating the 
end of a 
pseudo-variable 
argument list 

PSLD 

PS 

Indicates a 
pseudo-code 
instruction for use 
by the final assembly 
listing phase 

PROC 

R,T PS 

Replaces the keyword 
PROCEDURE 

PROC* 

T. PS 

Triple which 
terminates the 
procedure block 
triples 

PTCH 

T 

Patch triple. Used 
by optimization phase 
to overwrite a triple 
in text at a point 
where code is to be 
inserted. The code 
to be inserted and 
the overwritten 
triple are held in a 
table in text blocks 

PUT 

R,T 

Replaces the keyword 
PUT 

R 

R # T 

Remote format 
statement marker 

READ 

R, T 

Replaces the keyword 
READ 

REAL 

R 

Replaces the keyword 
REAL 

RECORD 

R 

Replaces the keyword 
RECORD 


RECURSIVE 

R 

Replaces the keyword 
RECURSIVE 

REENTRANT 

R 

Replaces the keyword 
REENTRANT 

REPLY 

R,T 

Replaces the keyword 
REPLY 

RETURN 

R,T 

Replaces statement 
marker 

REVERT 

R, T 

Replaces the keyword 
REVERT 

REWRITE 

R,T 

Replaces the keyword 
REWRITE 

RPL 

T 

Code byte or triple 
indicating the start 
of a format list 
replication factor 
expression 

RPL* 

T 

Triple indicating the 
end of a format list 
replication factor 
expression 

RWA 

PS 

Indication of an 
addressing vector for 
use by the register 
allocator when the 
number of symbolic 
registers in use 
exceeds the amount of 
work space which has 
been allocated 

SECONDARY 

R 

Replaces keyword 
SECONDARY 

SECOND LEVEL 
MARKER 

R 

A code byte which 
immediately precedes 
all code bytes 
appearing in the 
second level table 

SELL 

T, PS 

Code byte or triple 
which indicates that 
a temporary variable 
is no longer required 

SET 

R,T 

Replaces the keyword 
SET 

SETS 

R 

Replaces the keyword 
SETS 

SEQUENTIAL 

R 

Replaces the keyword 
SEQUENTIAL 

SIGNAL 

R,T 

Replaces the keyword 
SIGNAL 

SIZE 

R 

Replaces the keyword 
SIZE 
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SKIP 

R,T 

Replaces the keyword 
SKIP 

SUBSCRIPT- 

R 

SL 

R,T,PS 

Statement label 
marker. Precedes all 

RANGE 




labelled statements 

SSB' 

T 

SN 

R,T,PS 

Statement number 
marker . Precedes all 
unlabelled statements 



SN2 

R,T,PS 

Marker which precedes 
a second file 
statement (See 

Appendix D.8) 

SSUB 

T 

SN3 

PS 

Indicates the start 
of a second file 
statement which is 
concerned with 

SYSTEM 

R,T 



initializing array, 
or structure, or 

SYSTEM' 

T 



string dope vectors. 
Similar to SN2 





(Appendix D.8) except 
that there is no 

TASK 

R,T 



associated entry 

THEN 

R,T 

SNAP' 

T 

Triple which 
indicates the end of 
a snap list 

TITLE 

R, T 

STATIC 

R 

Replaces the keyword 
STATIC 

TMPD 

T 

STERLING 

R 

Marker which precedes 



DECIMAL REAL 


a sterling decimal 





constant 

TO 

R,T 

STOP 

R,T 

Replaces the keyword 
STOP 

TO' 

T 

STREAM 

R 

Replaces keyword 

STREAM 



STRING 

R,T 

Replaces the keyword 
STRING 

TRANSMIT 

R 

STRING * 

T 

Triple indicating the 
end of a string list 
used with list 

UNBUFFERED 

R 



directed I/O 

UNDEFINEDFILE 

R 

STRINGRANGE 

R 

Replaces the keyword 
STRINGRANGE 

UNDERFLOW 

R 

SUB 

R 

Replaces the keyword 

SUB used in iSUB 
DEFINING marker 

UNLOCK 

R,T 



preceding a BIT 

UPDATE 

R 

SUBSCRIPT 

R,T 

Marker which precedes 
the parenthesized 
subscript list of an 
array 

USES 

R 

SUBSCRIPT* 

T 

Triple indicating the 

USNG 

PS 
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end of a subscript 
list 

Replaces keyword SUB- 
SCRIPT RANGE 

Super subs prime 
triple. Similar to 
SUBS'. Used by 
Optimization phases 
in conjunction with 
SSUB 

Super subs triple. 
Similar to SUBS. 

Used by Optimization 
phases 

Replaces the keyword 
SYSTEM 

Triple which 
indicates the end of 
a system list 

Replaces the keyword 
TASK 

Replaces the keyword 
THEN 

Replaces the keyword 
TITLE 

Triple indicating a 
temporary expression 
result 

Marker replacing TO 
in the iterative DO 
statement 

Triple which 
indicates the end of 
a TO expression 

Replaces the keyword 
TRANSMIT 

Replaces the keyword 
UNBUFFERED 

Replaces the keyword 
UNDEFINEDFILE 

Replaces keyword 

UNDERFLOW 

Replaces the keyword 
UNLOCK 

Replaces keyword 
UPDATE 

Replaces the keyword 
USES 

Indicates the 
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USSL 

VARYING 

WHILE 


PS 


R 


R,T 


presence of an WHILE* T 

assigned register 

Indicates a list of 
symbolic registers 

which need not be WRITE R,T 

saved on branch and 
branch and link 
instructions 

X R,T 

Replaces the keyword 
VARYING 

ZERODIVIDE R 

Replaces the keyword 
WHILE 


Triple which 
indicates the end of 
a WHILE expression 


Replaces the keyword 
WRITE 


Spacing format item 


Replaces the keyword 
ZERODIVIDE 
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APPENDIX E: STORAGE REQUIREMENTS 


The (F) Compiler requires main storage for 
the following purposes : 

Compiler processing phases 

Print buffers 

Compiler control routines 

Dictionary area 

Text area 

Input/Output buffers 


The dictionary and text block size is 
chosen according to the amount of main 
storage available to the compiler. The 
SIZE option, interpreted at invocation 
time, provides the value used to determine 
the block size. The space needed for large 
I/O buffers is subtracted from SIZE and the 
space remaining is used when determining 
text and dictionary block size, as detailed 
in the publication IBM System/360 PL/I (F) 
Programmers Guide, A table contained in 
Phase AB is searched, using the SIZE option 
as an argument, when the correct entry is 
found, the block size is extracted. 


Input/Output routines (BSAM) 

The main storage required by each phase 
of the compiler need be contiguous only for 
each control section. 

During the read-in phases a minimum of 
two dictionary blocks and two text blocks 
is available in storage simultaneously. 

During the optimization logical phase, a 
minimum of three dictionary and five text 


blocks are available in storage 

1 

a i 

IK 

j 44K - 

56K 

simultaneously . 

1 

B | 

2K 

| 56K - 

72K 


1 

C 

4K 

| 72K - 

132K 

During the rest of the compilation four 

1 

D | 

8K 

| 132K - 

168K 

dictionary blocks and four text blocks are 

1 

E | 

16K 

| 168K 



available in storage simultaneously. 


The first table shows the relationship 
between the compiler requirements and the 
text and dictionary block sizes. The 
second table details the storage allocation 
in each environment. 


t t 1 

Environment | Diet ionary /Text | Compiler 

Block Size | Requirements 


— j 
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Initially, four text and four dictionary 
blocks are allocated to the compiler (two 
each are allocated when only 44K bytes of 
storage are available to the compiler. 

This is then expanded to four of each at 
the end of the read-in phase). If the text 
and/or dictionary expands to fill these 


blocks, more main storage is allocated as 
blocks. This process continues until the 
spill point is reached (i.e., until all the 
main storage available to the compiler has 
been used) . If still more main storage is 
required, the spill file (SYSUT1) is 
opened, and blocks are written out. 


450 



APPENDIX F: COMMUNICATIONS REGION 


The communications region is an area 
specified by the control routines (see 
Appendix L) t and used to communicate 
necessary information between the various 
phases of the compiler. The communications 
region is resident in the first dictionary 
block throughout the compilation. 

Notes The use of the communications region 
during compile- time processing is 
described in Appendix J. 

The tables below give the following 
information for each location of the 


communications region: name of location; 
offset (i.e. f relative address); use (i.e., 
stages of compilation during which the 
location is in use) ; and a description of 
the contents. Certain locations are used 
in one capacity during part of the 
compilation and then re-used in a 
different capacity during another part of 
the compilation, in these cases , one 
location will have two table entries: 
details of alternative usage appear in the 
columns headed Name a , Use a , etc. 
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Table 1. Communications Region 






1 


T 

T 


f 


— i 

1 

L. 

Name 

joffset (Dec. 

4 _ . 

) 1 

Use 

1 

i 

Description 

1 

| 

r 

i 

SAVEO 

1 

1 o 

| ALL 


PHASES 1 

Register save area 

— 1 

i 

SAVE1 

| SAVE 0+4 

| ALL 


PHASES 

1 

Register save area 


i 

i 

SAVE 2 

| SAVE0+ 8 ETC. 

1 m 

1 • 

| ALL 

1 

1 

• 

PHASES 

1 

1 

1 

Register save area 

• 

• 


i 

i 

i 

SAVE 15 

1 • 

| SAVE0+ 6 0 

I 

1 

j ALL 

* 

PHASES 

1 

1 

1 

• 

Register save area 


i 

ZTV 

| 64 

| ALL 


PHASES 

1 

Control phase base 


i 

ZTRANl 

| 68 

| ALL 


PHASES 

1 

External to internal translate table 


i 

Z TRAN 2 

j ZTRAN1+4 

| ALL 


PHASES 

1 

Internal to external translate table 


i 

ZNXTD 

1 76 

| ALL 


PHASES 

1 

Next available dictionary location 


i 

ZERRD 

| 80 

| ALL 


PHASES 

1 



i 

ZERRS 

| ZERRD+4 

| ALL 


PHASES 

1 

First locations of error chains 


i 

ZERRW 

j ZERRD+8 

j ALL 


PHASES 

1 



i 

ZERRC 

| ZERRD+12 

| ALL 


PHASES 

1 



i 

ZDNXT 

j ZERRD+16 

| ALL 


PHASES 

1 



i 

ZSNXT 

|ZDNXT+4 

| ALL 


PHASES 

1 

Current ends of error chains 


i 

ZWNXT 

| ZDNXT+8 

| ALL 


PHASES 

1 



i 

ZCNXT 

j ZDNXT+12 

| ALL 


PHASES 

1 



i 

i 

Z MY NAM 

| 112 

j ALL 
| 


PHASES 

1 

i 

Name of last phase entered 


i 

i 

DICTP 

| 116 

| ALL 


PHASES 

1 

1 



i 

ZCNCHR 

t 118 

| ALL 


PHASES 

1 

Source column containing control 


i 



1 



1 

character 


i 

ZPROCH 

| 120 

| ALL 


PHASES 

1 

Chain of created procedures 


i 

ZSTAT 

j 124 

| ALL 


PHASES 

1 

Current statement number 


i 

PARI 

| 128 

j ALL 


PHASES 

1 

Parameter word 1 


i 

i 

i 

PAR2 

j PARl+4 ETC. 

| ALL 

1 

l 

• 

PHASES 

1 

1 

1 

Parameter word 2 


1 

i 

i 

PAR8 

1 • 

|PARl*28 

1 

1 

| ALL 

• 

• 

PHASES 

1 

1 

1 

• 

• 

Parameter word 8 


i 

CORLFT 

| 160 

| ALL 


PHASES 

1 

Amount of core left for compilation 


i 

LKNAME 

| 164 

| PHASE 

VE 

1 

Member name of module produced by 


i 



1 



1 

compilation 


i 

ZOBSAD 

1 172 

| ALL 


PHASES 

1 

Address of overflow block 


i 

■ 

TERMSW 

| 176 

| ALL 
j 


PHASES 

1 

i 

compilation terminating switch 


1 

i 

OFDNAM 

| 178 

| ALL 


PHASES 

I 

1 



i 

SPLNAM 

| 180 

j ALL 


PHASES 

1 

Name of phase in control when 


i 



1 




.spill file is opened 


i 

ZOBNUM 

| 182 

| ALL 


PHASES 

1 

Overflow block number 


i 

SCNOP 

| 184 

1 ALL 


PHASES 

1 

Phase directory scan switch 


i 

SCCNF 

| 185 

j ALL 


PHASES 

1 

On if in second half of compiler 


i 

ZDROLF 

| 186 

| ALL 


PHASES 

1 

Overlay switch 


i 

AREA 

j 187 

| ALL 


PHASES 

1 

Code word for dummy routines 


i 



1 



1 

(phase AD) 


i 

ZM91 

| 188 

| ALL 


PHASES 

1 

(used for Model 91 systems) 


i 

PERRSW 

| 189 

| ALL 


PHASES 

1 

Print error switch 


i 

BERSW 

| 190 

j ALL 


PHASES 

1 

♦ process error byte 


i 

IOERSW 

| 191 

| ALL 


PHASES 

1 

I/O error switch 


i 

ZPAGE 

| 192 

| ALL 


PHASES 

1 

Number of lines in page 


i 

ZLINE 

| 194 

| ALL 


PHASES 

1 

Number of characters in a line 


i 

ZOPT 

| 196 

| ALL 


PHASES 


Code word of loading of optimizing 


i 



1 



1 

phases 


i 

PARMLEN 

| 197 

| ALL 


PHASES 

1 

Length of options field in * - process | 

i 



1 



1 

card 

1 

i 

MAXFON 

| 198 

| ALL 


PHASES 

1 

Number of offset slots in a dictionary! 

i 



1 



1 

block 

1 

i 

ZDICTSP 

| 200 

j ALL 


PHASES 

1 

Useful dictionary block size 

1 


Note : If a program interrupt occurs both LKNAME and CORLFT are overwritten by the 
interrupt PSW. 
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Table 1. Communications Region (cont'd) 


r~ 

1 

1 

Name j Offset (Dec. 

) 1 

| ALL 

Use 1 

PHASES | 

Description 

— i 

1 

■ 

r 

1 

ZNXTOF j 

204 

Offset of next dictionary entry 

1 

1 

FONOF j 

208 

j ALL 

PHASES j 

Offset of offset slots in dictionary 


1 

1 

1 

FSTDRF j 

212 

1 

i ALL 

1 

PHASES j 

block 

Dictionary reference of last diction- 


1 

1 

1 

ERCODE j 

224 

1 

| ALL 

1 

PHASES j 

ary entry 

Error message codes 


1 

MCSIZE j 

228 

| ALL 

PHASES j 

M/CSIZE this run 


1 

CCCODE j 

232 

j ALL 

PHASES j 

Control card requests 


1 

1 

HDR j 

236 

1 

j ALL 

PHASES | 

(see table 4 below) 

Address of phase directory 


1 

TLR j 

240 

j ALL 

PHASES j 

Timer last read 



TRT | 

244 

| ALL 

PHASES j 

Total run time 


1 

ARINT | 

248 

| ALL 

PHASES j 

Arithmetic interrupt 


1 

BR2 j 

252 

j ALL 

PHASES j 

Second base for control phase 


1 

STARTX | 

256 

| ALL 

PHASES j 

Start of text 



DICTSZ j 

260 

| ALL 

PHASES j 

Dictionary block size 


1 

TXTSZ | 

264 

j ALL 

PHASES j 

Space available in text block 



RDS1ZE j 

268 

j ALL 

PHASES j 

SIZE of read area 


1 

INCOD j 

272 

j ALL 

PHASES j 

Interrupt code 


1 

ARMASK j 

273 

j ALL 

PHASES j 

Arithmetic error mask 


1 

LOCK j 

274 

j ALL 

PHASES j 

Dictionary lock slot 


1 

ZNXTLC | 

276 

j ALL 

PHASES j 

End of current text 


1 

Z SHIFT | 

280 

j ALL 

PHASES j 

Number of bits in dictionary reference | 

1 

1 

ZMASK 1 

284 

1 

j ALL 

PHASES | 

offset 

Mask to remove block numbers 


1 

ZMASK1 1 ZMASK ♦ 2 

j ALL 

PHASES j 

Mask to remove offset 


1 

ZSOR j 

288 

j ALL 

PHASES j 

Input record source 


1 

ZMAG j 

290 

j ALL 

PHASES j 

Input record margin 



CCCODEE 

292 

j ALL 

PHASES 

Control card requests 


1 

L. 

ZCOMM | 304 

| ALL PHASES | 

— J— X. 


i 
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Table 2 . Communications Region 


T 

r 






| Dec. | 

Use 

1 

1 1 Use a 




1 MamA 1 



1 v 


T 



*4 Description a | 

1 

i 

Start j End 

1 

1 | Start 

| End 


+ — 

+ 

— — ■— i— — — — — 


| j 

+ 

.4 .j 

ZCALLC ZCOMM+ 01 

Read in |BCD to 

| Start of CALL 

| | 

| 

| | 

1 


(Diet. Ref. 

j chain 

1 I 

I 

| | 

ZLABTB | 

♦ 4 I 

Read in j Initial 

j Start of label 

I 1 

| 

| ( 



1 

j chain 

1 1 

1 

1 | 

ZATTID| 

♦ 8 1 


j Pointer to 

(ZPCOP j 

I 

| | 

1 


1 

| attribute 

1 1 

1 

1 | 

1 


1 

j tidy-up area 

1 I 

1 

1 1 

ZALLCH | 

+12 J 

Read in | ALLOCATE ♦ 

Start of 

1 1 

| 

| | 

1 


j Attribute 

1 ALLOCATE chain 1 1 

( 

1 | 

ZFLAGl | 

♦16 1 

Read in j Dictionary 

|Flag bytes. 

1 1 

1 

1 ( 

Z FLAG 2 j 

♦ 17 1 

1 

| mainly used 

1 1 

1 

1 I 

Z FLAG 3 | 

♦18 1 

1 

j for optional 

1 1 

1 

1 1 

ZELAG 4 | 

+ 19 1 

1 

| phase 

1 i 

1 

1 1 

Z FLAG 5 j 

+20 j 

1 

(marking (see 

(ZSYSOTj Pseudo 

| Pseudo | Diet. Ref. ! 

1 


1 

j table 3 below) 

| j code 

| code 

| SYSOUT j 

ZFLAG6 | 

+ 21| 

FU |QU 

j Unaligned 

1 1 

1 

1 1 

1 


1 

j (see Table 3 ) 

1 1 

1 

1 1 

UNUSED j 

+ 21 1 



I 1 

1 

1 1 

I 

Toj 

1 


1 1 

1 

1 1 

1 

♦ 23 j 

1 


1 I 

1 

1 1 

ZSCRCH | 

♦ 24 1 

PD j PL 

| Address of 


1 

1 1 

1 


1 

j scratch core 

1 1 

1 

1 1 

1 


I 

j kept across 

1 1 

1 

1 1 

1 


1 

| phases 

1 1 

1 

1 1 

UNUSED j 

♦ 25 1 

1 


1 1 

1 

1 1 

1 

TO j 

1 


1 1 

1 

1 1 

I 

♦ 27 1 

1 


1 1 

1 

1 1 

ZHASH | 

♦ 28 j 

Dictionary | Dictionary 

j Start of hash 

(ZINCL jPC. 

|End 

j INCLUDE card j 

1 


1 

j table 

1 1 

1 

j pointer | 

1 

♦32 1 

Not used | Not used 


( ZEQTA 3 j Final 

I Assy. 

j Assigned j 

1 


1 


1 1 


j offset table j 

ZFATTB j 

+36 1 

Dictionary | Declare 

j Start of fact- 

j ZLCONS j Strge 

| Alloc 

j Last constant j 

1 


jpass 2 

j ored attribute 

jZEOCS j 

1 

jin STATIC. | 

1 


1 


1 1 

1 

End of STATIC 

ZCDIMC j 

♦40 1 

Dictionary | Pre- 

j Start constant 

j ZSMREGj Trans- 

| Pseudo | Current sym- | 

1 


j translator 

| dimension 

| j lator 

(code 

(bolic register | 

Z 2 FILE | 

♦44 | 

Dictionary j End 

j Start of 

i 1 

1 

1 1 

I 


1 

j second file 

1 1 

1 

1 1 

ZDLFST j 

♦ 48 1 

Dictionary | Storage 

j Defined 

( ZFSTEXj strge 

(End 

(First external | 

1 


j allocator 

j storage area 

j | alloc 

1 

j item j 

ZDCBLD j 

+ 52 1 

Dictionary j Dictionary 

j Dictionary 

|ZPRSIZ| Final 

(Assy. 

(Size of com- j 

1 


1 

j build area 

I 1 

1 

| pi led program j 

ZMPSTK j 

♦ 56 1 

Dictionary j Translator 

j Program map 

j ZSICSZ| Final 

1 Assy. 

j STATIC | 



1 

j stack 

1 1 

1 

(INTERNAL size 

ZUPIC | 

♦ 60 1 

Dictionary j Picture 

j Start of 

1 ZSTALC I Final 

| Assy. 

| Storage loc- i 

1 


j processor 

j picture chain 

1 1 

1 

(at ion counter | 

ZPROCl j 

♦ 64 1 

Dictionary j End 

| Start of entry | | 

1 

1 

1 


1 

|type 1 chain 

1 i 

1 

1 

ZSTACH | 

♦ 68 1 

Dictionary | End 

1 Start of STAT- 

1 I 

1 

1 

| 


1 

| IC chain (6) 

1 1 

1 

1 

ZVDIMC j 

♦ 74 1 

Dictionary j Translator 

j Start of vari- 

1 1 

1 

1 

| 


1 

| able dimension! S 

1 

1 

1 


1 

| chain 

1 1 

1 

I 

Z CONCH | 

♦78 1 

Dictionary | ALLOCATE 

| Start of con- 

i 1 

1 





j stants chain 

1 1 

1 


ZDEFCH| 

♦ 80 j 

Dictionary j Dictionary 

j Chain of 

j ZCITEM jPre 

(End 

| Chain of CON- 

| 


1 

j defined items 

i trans. 

1 

j TROLLED items 

ZLIKCH j 

♦ 82 | 

Dictionary | Dictionary 

j Chain of LIKE 

| ZEQMAX j Pseudo | End 

| Max. label 

1 


1 

j items 

( | code 

1 

j number 
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Table 2. Communications Region (cont*d) 


Name j 

Dec. ( 

Offset 1- 

Use 

Start | End 

i 

1 

— | Description 

1 



T 

t ■ ■■ 

ZPOLCH j 

♦841 

Dictionary 

Dictionary! Chain of POOL 

1 




| items 

1 

ZDC0M1 | 

ZCOMM+ 86 1 

Dictionary 

1 

Dictionary! Latest 





}dict. ref. 

1 

Z DCOM 2 | 

+ 90| 

Dictionary 

i 

Dictionary! Flags for die- 

1 




|tionary build 





(interface 





j (8 bytes) 

ZDSA | 

ZCOMM+ 94 1 

PA 

UD 

(Head of STATIC 





(DSA chain 

ZCPOFF | 

ZCOMM| 

PD 

UA 

j Offset of 


♦100 1 



j first 





| constants pool 





(within static 





j internal. 

MACRON | 

ZCOMM | 

BW 

TP 

| Macro reqel 


+336| 



j count 





j (halfword) 

SOURCN | 

ZCOMM | 

Cl 

TP 

(Source reqd 


♦338 1 



j count 





j (halfword) 

STMNTN | 

ZCOMM | 

Cl 

TP 

(Source b tint 


♦340| 



| count 





( (halfword) 

INSTRN | 

ZCOMM | 

TJ 

TP 

(Object instn 


♦342| 



j count 





j (halfword) 

BYTESN | 

ZCOMM | 

TO 

TP 

j Object byte 


♦344| 



j count 





j (fullword) 

ZSAV | 

ZCOMM | 

Resident 

Resident 

(Register save 


+360| 

Control 

Control 

1 area 





| (18 fullwords) 


Name a j- 


(. 

ZOSMRG 


Z COBOL 


Use a 

’V 


Start | End 


Pseudo 


code 

j code 

(optimization 


1 

( symbolic reg- 


1 

j isters 

GB 

j JI 

|Head of COBOL 


Pseudo 


Descript ion 2 


End of 


structure 

chain 


NOTE : Bytes ZCOMM+60 to ZCOMM+332 are used internally within the Read-in phase and cannot 
be assumed to be zero at exit from that phase. 

Bytes ZCOMM+336 to ZGOMM+344 are not available for re-use 

Bytes ZCQMM+104 to ZCOMM+131 are used by the generic phase IM. They are cleared 
before exit from the phase. 
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Table 3. Communications Region. Bit Usage in Z FLAGS 


j BYTE 

T* 

1 

OFFSET 

T” 

1 

BIT 

“T” 

1 

BIT NAME 

T DESCRIPTION 


j NAME 
f ZFLAG1 

1 

.X. 


1 

X_ 

(HEX) 

1 

-4— 


1 Bits are set on, on encountering:- 

j DEFINED attribute 

H 

T 

1 

ZCOMM+16 

T 

1 

80 

T 

1 

ZDEFFL 


1 


1 

40 

1 

ZAWAFL 

j ALLOCATE statement 



1 


1 

20 

1 

ZSECFL 

j Second File statement 



1 


1 

10 

1 

ZDIMFL 

j Dimension attribute 



1 


1 

08 

1 

ZCHKFL 

| CHECK/NOCHECK prefix 



1 


1 

04 

1 

ZONFL 

j ON, SIGNAL or REVERT statement 



1 


1 

02 

1 

ZSTRFL 

j Structure 



1 

i 


1 

i 

01 

1 

ZDECFL 

j DECLARE statement 


| Z FLAG 2 

i 

1 

♦17 

i 

1 

80 

1 

1 

ZLIKFL 

1 LIKE attribute 



1 


1 

40 

1 

ZINTST 

j STATIC INITIAL 



1 


1 

20 

1 

ZOPCFL 

| OPEN/CLOSE statement 



1 


1 

10 

1 

ZGTPFL 

j GET/PUT statement 



1 


1 

08 

1 

ZGOTFL 

j GO TO statement 



l 


1 

04 

1 

ZTEPFL 

J TASK/EVENT/PRIORITY options, REPLY statement 



1 


1 

02 

1 

ZPICFL 

j PICTURE attribute/format item 



1 


1 

i 

01 

1 

| 

ZISBFL 

| iSUB defining 


| ZFLAG3 

i 

1 

♦18 

1 

1 

80 

1 

1 

ZCONTG 

| UNALIGNED (NONSTRING) attribute 



l 


1 

40 

1 

ZSETFL 

j SETS attribute 



l 


1 

20 

1 

ZOSSFL 

j DELAY, DISPLAY, WAIT statement 



1 


1 

10 

1 

ZARGFL 

| Argument list 



1 


1 

08 

1 

ZINLFL 

j INITIAL Label 



1 


1 

04 

1 

ZDIOFL 

j DATA directed I/O 



1 


1 

02 

1 

ZRECIO 

j RECORD I/O 



1 

i 


I 

i 

01 

1 

| 

ZINTAC 

j AUTO/CTL initialization 


| ZFLAG4 

i 

1 

♦191 

80 

1 

1 

ZFREE 

j FREE statement 



1 


1 

40 

1 

STM256 

j More than 256 statements 



1 


1 

20 

1 

FILEFL 

j Files present 



1 


1 

10 

1 


j Spare 



1 


1 

08 

1 

ZPUTFL 

j PUT DATA 



1 


1 

04 

1 

ZGETFL 

j GET DATA 



l 


1 

02 

1 

ZPTRFL 

j Pointer Qualifier 



l 

a 


1 

i 

01 

1 

1 

ZRODFL 

j STATIC DSA Entry 


| ZFLAG5 

i 

♦20 

i 

1 

80 

1 

1 

Z FT ASK 

| TASK/EVENT/PRIORITY option on a CALL statement 



1 


1 

40 

1 

ZDENFL 

j Set by FT 



1 


1 

20 

1 

ALCSLM 

| ALLOCATE, with second level marker 



1 


1 

10 

1 


j Spare 



1 


1 

08 

1 


j Spare 



1 


1 

04 

1 


j Spare 



1 


1 

02 

1 


j Spare 



1 


1 

• 

01 

1 

| 


j Spare 


| ZFLAG6 

i 

1 

+ 21 

i 

1 

80 

1 

1 

ZUNAFL 

j ON for unaligned data: set by FU 



1 


1 

40 

1 


j Spare 



1 


1 

20 

1 


j Spare 



1 


1 

10 

1 


j Spare 



1 


1 

08 

1 


j Spare 



1 


1 

04 

1 


j Spare 



1 


1 

02 

1 


j Spare 


j 

1 

.X. 


1 

X- 

01 | 


j Spare 

-j 


456 


Table 4. Communications Region, 
in CCCODE. 


Byte I Bit 


DUMP 1 wanted 

0 not wanted 


Bit usage 

— 1 

I 


f BYtejli^ j _ | 



1 


1 abort has occurred 

1 

1 

1 

1 

1 

1 2 

| BCD 

1 

1 

BCD input | 





1 

1 

1 

1 

0 

EBCDIC input j 


2 

LIST 

1 not wanted 

0 wanted 

t 

1 

1 

1 

1 

1 3 

1 

j SOURCE2 

1 

wanted j 





1 

1 

1 

1 

0 

not wanted j 


3 

LOAD 

1 not wanted 

0 wanted 

1 

1 

1 

1 

1 

1 4 

1 

jOPT 

1 

wanted | 





1 

1 

1 

1 

0 

not wanted j 


4 

DECK 

1 not wanted 

0 wanted 

1 

1 

1 

1 

1 

1 

1 

1 5 

1 

1 

1 

fl 

1 

AE required | 


5 

EXTREF 

1 not wanted 

1 

1 

1 

1 

1 

1 6 

1 

1 

1 

program check j 




0 wanted 

1 

I 

1 

1 

1 

1 

1 


has occurred j 


6 

XREF 

1 not wanted 

0 wanted 

1 

1 

1 

1 

1 

1 

1 

Y — 

1 3 

1 

1 7 

1 

1 o 

1 

1 

1 

4- 

1 

means first record j 
has been read j 

not wanted j 


7 

ATR 

1 not wanted 

1 

1 

T 

| STMT 

1 




0 wanted 

1 

1 

1 

1 

1 

I 

1 

1 

0 

wanted j 

1 

— 

0 


1 means U- format 

1 

1 

1 

1 1 

1 

j MACDCK 

1 

not wanted j 




0 means F- format 

1 

1 

1 

1 

0 

wanted j 




records on input 

1 

l 

1 

1 

1 

1 2 

1 

j COMP 

1 

not wanted j 


1 


1 if track overflow 

1 

1 

1 

1 

0 

wanted j 




is present 

1 

1 

1 

1 

1 

j 3 

1 

1 

1 

macro phase now j 


2 


Severity code 


1 

1 

1 


running | 


3 


Severity code 

1 

1 

1 

1 




4 


Severity code 

1 

1 

1 4 

1 

1 

batch record found | 


5 


Severity code 

1 

1 

1 


0 

batch record not | 




where 0000=FLAGW 

1 

1 

1 

1 


found ! 




0001=FLAGE 
0010— FLAGS 

1 

1 

1 

1 

1 

1 3 

1 

1 

1 

EOF record found j 





1 

1 

1 

1 

0 

EOF record not found! 


6 

CHAR 48 

1 not wanted 

0 wanted 

1 

1 

I 

1 

1 

1 

1 

1 6 
l 

1 

1 

1 


not used requirement! 


7 

MACRO 

1 not wanted 

I 

I 

1 

1 

1 

1 7 

1 

j NEST 

1 

wanted j 

_____ 

— 

_____ 

0 wanted 

1 

j 

j 

j 

1 

_A 

0 

not wanted j 


SOURCE 


CHK 


1 not wanted 

0 wanted 

1 not wanted 
0 wanted 
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APPENDIX G: SYSTEM GENERATION 


For full details of the system generation 
process, see IBM System/360 Operating 
System: System Generation , Form C28-6554. 

During the system generation process, a 
control section named IEMAF (see Figure 13) 
is assembled containing a table consisting 
of a bit string field that is fourteen 
bytes in length, immediately followed by 
seven fixed-point values aligned on 
full-word boundaries. The first five 
fixed-point values are related to the 
compiler options LINECNT, SIZE, SORMGIN 
(start), SORMGIN (end), and PAGECTL 
(control column) respectively. The 


remaining two fixed-point values are spare 
fields not currently in use. Bits 0 to 25, 
28 to 46 and 51 to 53 in the string are 
used to specify the default status of the 
options. (Note: bit 51 is used for both 
default and delete.) Bits 54 to 81, and 83 
to 102 in the string are used to specify 
whether an option keyword is to be deleted 
or not. A "1" in the bit string means 
"yes" and a *0" means "no". The remaining 
bits in the string are spare bits not 
currently in use. Figure 14 shows the bit 
identification table associated with the 
control section. 


r — “ 

j IEMAF 

START 















— i 

1 

-H 


DC 

B'io 0 

0 

0 

0 

o 

o 

o 

0 

0 

0 

0 

0 

0 

0 

0 

« 

DEFAULT 


DC 

1 

B' jO 0 

0 

0 

0 

0 0 0 

0 

0 

0 

0 

0 

0 

0 

0 

• 

SWITCHES 



DC 

B' |0 0 
j 

0 

0 

0 

0 0 0 

0 

0 

0 

0 

0 

0 

0 

0 

1 


-H 


DC 

B'|0 0 

j 

0 

0 

0 

O 

o 

— 

o 

0 

0 

0 

0 

0 

0 

0 

0 

• 

DELETE 


DC 

B'|0 0 

1 

0 

0 

0 

0 0 0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

SWITCHES 



DC 

B' |0 0 

0 

0 

0 

0 0 0 

0 

0 

0 

0 

0 

0 

0 

0 

• 


-H 

-H 


DC 

1 

B'|0 0 

0 

0 

0 

1 — 
0 0 1 0 
J — 

0 

0 

0 

0 

0 

0 

0 

0 

• 

SPARE SWITCHES 


DC 

F' 60 ' 
















DC 

F* 999999 ' 
















DC 

F' 2* 

















DC 

F* 72 ' 

















DC 

F ' 0 ' 

















DC 

F* O' 
















! 

DC 

F* O' 















j 


•Figure 13. The IEMAF Control section 
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r r - 

1 Bit 1 

Parameter 

“1 

j Bit 

r~ 

1 

Paramter 

T T - 

1 Bit 1 

Parameter 

1 

f 

+- 

— 

H 

+- 


+ 4 


0 

1 

ATR 

| 38 

1 

NONEST 

1 75 1 

DELETE=SOURCE2 


1 

1 

NOATR 

j 39 

1 

COMP 

j 76 I 

DELETE-NOSOURCE2 


2 

1 

BCD 

1 40 

1 

NOCOMP 

177 I 

DELETE=OPT 


3 

1 

EBCDIC 

j 41 

1 

OB JIN 

1 78 | 

DELETE=LINEC NT 


4 

1 

CHAR60 

| 42 

1 

OBJOUT 

1 79 | 

DELETE=LINELNG 


5 

1 

CHAR48 

j 43 

1 

MACDCK 

1 80 | 

DELETE=SIZE 


6 

1 

DECK 

| 44 

1 

NOMACDCK 

| 81 I 

DELETE=S0RM3 I N 


7 

1 

NODECK 

1 45 

1 

EXTDIC 

1 82 1 

Not used 


8 

1 

EXTREF 

| 46 

1 

NOEXTDIC 

1 83 | 

DELETE=STMT 


9 

1 

NOEXTREF 

1 47 

1 

Not used 

1 84 1 

DELETE— NOSTMT 


10 

1 

FLAGW 

1 48 

1 

Not used 

1 85 | 

DELETE=MACRO 


11 


FLAGE 

| 49 

1 

Not used 

| 86 | 

DELETE=NOMACRO 


12 

1 

FLAGS 

| 50 

1 

Not used 

1 87 | 

DELETE-COMP 


13 

1 

LIST 

| 51 

1 

DEFAULT/DELETE 

| 88 | 

DELETE=NOCOMP 


14 

1 

NOLIST 

1 

1 

(Bit always 0) 

| 89 | 

DELETE-OBJIN 


15 

1 

LOAD 

1 52 

1 

LIB=REAL 

| 90 1 

delete=objout 


16 

1 

NOLOAD 

1 53 

1 

LI B= COMP LEX 

1 91 | 

DELETE=PAGECTL 


17 

1 

XREF 

| 54 

1 

DELETE®ATR 

1 92 | 

DELETE=MACDCK 


18 

1 

NOXREF 

155 

1 

DELETE=NOATR 

1 93 | 

DELETE=NOMACDCK 


19 

1 

SOURCE 

156 

1 

DELETE=BCD 

| 94 | 

DELETE=EXTDIC 


20 

1 

NOSOURCE 

1 57 

1 

DELETE=EBCDI C 

| 95 | 

DELETE-NOEXTDIC 


21 

1 

SOURCE2 

158 

1 

DELETE® CHAR 6 0 

| 96 | 

DELETE=OPLIST 


22 

1 

NOSOURCE2 

| 59 

1 

DELETE=CHAR48 

1 97 1 

delete®nooplist 


23 

1 

OPT=0 

160 

1 

DELETE®DECK 

1 98 1 

DELETE® NEST 


24 

1 

OPT=l 

| 61 

1 

DELETE=N ODEC K 

1 99 | 

delete® nonest 


25 

I 

OPT=2 

1 62 

1 

DELETE=EXTREF 

1 100 | 

delete=synchke 


26 

1 

Not used 

| 63 

1 

DELETE=NOEXTREF 

| 3.01 1 

DELETE=SYNCHKS 


27 

1 

Not used 

164 

1 

DELETE®FLAGW 

1 102 1 

DELETE®SYNCHKT 


28 

1 

SYNCHKE 

| 65 

1 

DELETE— FLAGE 

1 103 | 

Not used 


29 

1 

SYNCHKS 

166 

1 

DELETE=FLAGS 

1 104 | 

Not used 


30 

1 

SYNCHKT 

1 67 

1 

DELETE=LIST 

1 105 | 

Not used 


31 


OPLIST 

168 

1 

DELETE=NOLIST 

1 106 1 

Not used 


32 

1 

NOOPLIST 

1 69 

1 

DELETE=LOAD 

1 107 | 

Not used 


33 

1 

STMT 

170 

1 

DELETE=NOLOAD 

1 108 1 

Not used 


34 

1 

NOSTMT 

1 71 

1 

DELETE=XREF 

1 109 1 

Not used 


35 

1 

MACRO 

172 

1 

DELETE=NOXREF 

1 110 1 

Not used 


36 

1 

NOMACRO 

1 73 

1 

DELETE=SOURCE 

1 111 | 

Not used 


37 

L 

1 

.X. 

NEST 

1 74 

_J 

1 

X- 

DELETE=NOSOURCE 

1 ! 

X X- 


-j 


•Figure 14. Bit Identification Table 
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APPENDIX H: CODE PRODUCE FOR PROLOGUES AND EPILOGUES 


The mechanism of dynamic storage management 
is described in the publication IBM 
Svstem/360 Operating System, PL/I 
Subroutine Library Program Logic Manual . 

Part of the code required to implement 
the storage management is generated as 
prologue and epilogue code by the compiler. 
This Appendix contains annotated examples 
of prologues and epilogues for PROCEDURE, 
BEGIN, and ON blocks. 


PROLOGUES AND EPILOGUES 

Example in PL/I 

A: Is PROCEDURE (X, Y) ; 

DECLARE Y CONTROLLED; 


ON OVERFLOW C=0; 

B: BEGIN; 

END; 

ABsIJK: ENTRY (Y,Z) 


RETURN ( EXPRESSION) 



• 

END; 



A 

BC 

15,16, (0,15) 

BRANCH ROUND FOLLOWING CONSTANTS 


DC 

All(l) 

LENGTH OF BCD 


DC 

C'A* 

BCD OF ENTRY POINT 

SIZDSA 

DC 

F* SIZE OF DSA* 


STATIC 

DC 

A (STATIC CONTROL 

ADDRESS OF STATIC INTERNAL CONTROL SECTION 



SECTION) 

(ONLY COMPILED FOR EXTERNAL AND ON PROLOGUES) 


STM 

14,11,12, (13) 

SAVE STANDARD REGISTERS IN SAVE AREA OF 


♦ 


CALLER'S DSA 


LR 

10,15 

SET UP FIRST PROLOGUE BASE 


BAL 

8,GETDSA( 0,10) 

CALL ROUTINE TO GET DSA 


MV I 

SWITCH (13) ,X'X1* 

INSERT RETURN (EXPRESSION) SWITCH 

* 



(ONLY COMPILED IF THERE IS A RETURN (EXP) 

* 



AND THE ENTRY LABELS HAVE DIFFERENT DATA 

* 



ATTRIBUTES) 


BC 

15, COPRAMl (0, 10) 

BRANCH TO COPY OVER PARAMETERS 
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I BC 15,10(0,15) 

DC AL1 (1) 

DC C*I' 

ADPRIM DC A (A) 

STM 14,11,12(13) 

* 

L 10 , ADPRIM (0,15) 

LA 8, IP (0 , 10) 

GETDSA L 11, STATIC (0,10) 

* 

L 0 , SIZDSA ( 0 , 10 ) 

L 15,32,(0,11) 

♦ 

* 

BALR 14,15 

LR 14,13 

LA 0,7, (0,0) 

SR 15,15 

LOOP A 14,0(0,11) 

ST 14, ADVEC+4 (15,13) 
LA 15,4(0,15) 

BCT 0,LOOP(0,10) 

BCR 15 , 8 

IP MVI SWITCH (13) ,X’X2' 

COPRAM1 L 14,0(0,1) 

ST 14,X(0 , 13) 

L 14,4(0,1) 

LA 0,10(0,0) 

SR 14,0 

LH 14,0(0,14) 

ST 14, Y(0 , 13) 

L 14,8(0,1) 

ST 14, TARGET (0,13) 

L 10 , A. . .A (0 ,11 ) 

* 

BAL 8, COMMON (0,10) 

* BCR 15,10 

* 

COMMON MVI 96 (13), X' 80' 

* 

BALR 10,0 

LA 9 , ADDAREA (0,13) 

* 

ST 9,ADVEC(0, 13) 


BRANCH ROUND FOLLOWING CONSTANTS 

LENGTH OF BCD 

BCD OF ENTRY POINT 

FIRST PROLOGUE BASE ADDRESS 

SAVE STANDARD REGISTERS IN SAVE AREA OF 

CALLER'S DSA 

SET UP FIRST PROLOGUE BASE 
SET RETURN REGISTER 

SET UP STATIC DATA POINTER (ONLY IN 
EXTERNAL PROCEDURES AND ON PROLOGUES) 

GR0=SIZE OF DSA 

LOAD GR15 WITH ENTRY POINT OF IHESADA 

(UNLESS DSA IS IN STATIC, WHEN ENTRY POINT OF 

COMPILER'S 'GET DSA' ROUTINE WILL BE LOADED) 

CALL ROUTINE TO GET A NEW DSA 

POINT GR14 AT NEW DSA 

SET LOOPING VALUE = 7 

CLEAR INDEXING REGISTER 

BUMP GR14 BY 4096 

STORE GR14 IN ADDRESSING VECTOR 

BUMP INDEX REGISTER 

BRANCH ON RETURN REGISTER 

INSERT RETURN (EXP) SWITCH 

PICK UP FIRST ARGUMENT ADDRESS AND 

STORE IN X IN DSA 

PICK UP SECOND ARGUMENT ADDRESS 

POINT GR14 AT PSEUDO-REGISTER OFFSET OF 

ARGUMENT AND PICK IT UP 

STORE OFFSET IN Y IN DSA 

PiqK UP ADDRESS OF TARGET FIELD 

AND STORE IN DSA 

LOAD GR10 FROM TRANSFER VECTOR SLOT 
FOR ENTRY POINT A IN STATIC. 

BRANCH AND LINK TO COMMON PROLOGUE 
BRANCH TO THE APPARENT ENTRY POINT 
FOR A 

SET DSA TASKING FLAG (ONLY COMPILED 
IF TASKING IN COMPILATION) 

SET UP COMMON PROLOGUE BASE 

SET GR9 TO POINT TO ADDRESSING AREA 

AT END OF DSA 

AND STORE IN ADDRESSING VECTOR. 


***** 

* 

* THE FOLLOWING CODE APPEARS 

* ONLY IN THE CASE OF RECURSIVE PROCEDURES 

* 

L 14, PR. . . A(12) LOAD GR14 WITH THE CURRENT DISPLAY 

* VALUE FOR A 

ST 14,92(0,13) STORE IN DISPLAY UPDATE IN DSA 

LA 14, PR. . .A (12) 

SR 14,12 GR14 = OFFSET OF DISPLAY PSEUDO-REGISTER 

ST 14,88(0,13) STORE IN DISPLAY UPDATE IN DSA 

* 

***** 


* INITIALIZE ON SLOTS (IF ANY) 

MVI 0 (13) , X* 8F* IDENTIFY DSA. 


* COPY SKELETON DOPE VECTORS (IF ANY) FROM STATIC INTERNAL 

* CONTROL SECTION TO REAL DOPE VECTORS IN DSA. (THERE IS ALWAYS A 
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* SKELETON FOR A REAL DOPE VECTOR) , AND RELOCATE THE ADDRESSES WITH THE 

* ADDRESS OF THE DSA FOR THOSE DOPE VECTORS REFERRING TO VARIABLES 

* IN THE DSA. 


* FOR EACH VDA (VARIABLE DATA AREA) REQUIRED BY THE 

* PROCEDURE THE CODE BETWEEN THE LABELS VDA1 AND VDA2 IS 

* GENERATED 


VDAl 

* 


SR 7,7 
SR 0,0 


CLEAR STORAGE ACCUMULATOR AC1 
CLEAR SECONDARY DOPE VECTOR STORAGE 
ACCUMULATOR AC 2 


* FOR EACH VARIABLE IN THE VDA, THE FOLLOWING CODE IS 

* GENERATED (BETWEEN LABELS VARl AND VAR2) . 


VAR1 EVALUATE EXTENT EXPRESSIONS (DIMENSIONS AND STRING LENGTHS) AND 

* STORE RESULTS IN DOPE VECTOR IN DSA. 

* ALIGN ACCUMULATOR AC1 ON CORRECT BOUNDARY FOR VARIABLE 

* BUMP ACCUMULATOR AC2 BY SIZE OF SECONDARY DOPE VECTOR (IF VARIABLE 

* IS DIMENSIONED AND VARYING). 

* RELOCATE ADDRESS IN VARIABLES DOPE VECTOR RELATIVE TO START OF 


* 

VDA. 



VAR2 

BUMP 

ACCUMULATOR ACl BY SIZE 

OF STORAGE REQUIRED FOR VARIABLE 


A R 

0,7 

ADD ACl AND AC2 


L 

15,36(0,11) 

LOAD GR15 WITH ENTRY POINT IHESADB 


BALR 

14,15 

GET VDA 


LA 

1, 8(0,1) 

BUMP VDA POINTER PAST FLAG AND CHAIN SLOTS 


AR 

7,1 

POINT GR7 AT FIRST SECONDARY DOPE VECTOR. 


L 

14, DV. .VAR (0,13) 

FOR EACH VARIABLE IN REGION, RELOCATE 


AR 

14,1 

ADDRESS IN DOPE VECTOR. 


ST 

14, DV. .VAR (0,13) 


* 

FOR EACH DIMENSIONED VARYING 

ITEM IN REGION, INITIALIZE 

VDA 2 

SECONDARY DOPE VECTORS. 



LA 

10 , PROCBASE 

SET UP PROCEDURE BASE 

CODE (IF ANY) TO SET UP SOME ADDRESSING MECHANISMS 
ADVANCE FOR USE IN PROCEDURE 


BCR 

15,8 

RETURN FROM COMMON PROLOGUE. 


CNOP 

0,4 


AB 

BC 

15,8(0,15) 

BRANCH ROUND BCD OF ENTRY POINT 


DC 

AL1 (2) 



DC 

C'AB' 



STM 

14,11,12(13) 

SAVE REGISTERS IN CALLER'S SAVE AREA 


L 

10, PROBAS (0,15) 

SET UP FIRST PROLOGUE BASE 


BAL 

8,GETDSA (10) 

BRANCH AND LINK TO GET DSA AND TO SET 

* 

MV I 

SWITCH (13) ,X ' X3 ' 

UP ADDRESSING VECTOR 

SET UP RETURN (EXP) SWITCH IF THERE IS 

* 



RETURN (EXP) AND DATA ATTRIBUTES OF 

* 

BC 

15,COPRAM2 (0,8) 

ENTRY LABELS DIFFER 

BRANCH TO COPY OVER PARAMETERS 

IJK 

BC 

15,12(0,15) 

BRANCH ROUND FOLLOWING CONSTANTS 


DC 

AL1 ( 3 ) 

LENGTH OF BCD 


DC 

C* IJK 1 

BCD OF ENTRY POINT 

PROBAS 

DC 

A(A) 

FIRST PROLOGUE BASE 


STM 

14,11,12(13) 

SAVE REGISTERS IN CALLER'S SAVE AREA 


L 

10, PROBAS (0,15) 

SET UP FIRST PROLOGUE BASE 


BAL 

8,GETDSA(0,10) 

BRANCH TO GET DSA AND SET UP 

* 

MV I 

SWITCH (13) ,X'X4' 

ADDRESSING VECTOR 

SET RETURN (EXP) SWITCH 

COPRAM 2 

L 

14,0(0,1) 

PICK UP FIRST ARGUMENT ADDRESS 


LA 

0,10(0,0) 



IN E 
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SR 

LH 

14,0 

14,0(0,14) 

PICK UP PSEUDO-REGISTER OFFSET OF 


ST 

14, Y(0 ,13) 

ARGUMENT AND STORE IN DSA. 


L 

14,4(0,1) 

PICK UP ADDRESS OF SECOND ARGUMENT 


ST 

14,Z(0,13) 

AND STORE IN Z 


L 

14,8(0,1) 

PICK UP ADDRESS OF TARGET FIELD 


ST 

14 , TARGET ( 0, 13 ) 

AND STORE IN DSA 


L 

10, A. . .A(0,11) 

LOAD GR10 WITH ADDRESS OF FIRST BYTE 

* 

BAL 

8 , COMMON (0,10) 

OF PROCEDURE 

BRANCH AND LINK TO COMMON PROLOGUE 


BC 

15, AE. . . AB(0,10) 

BRANCH TO APPARENT ENTRY POINT AB 

* 

THIS 

IS THE APPARENT ENTRY 

POINT OF A. 


* 

THE FOLLOWING IS AN ON 

BLOCK PROLOGUE WHICH IS COMPILED FOR ALL 

* 

ON BLOCKS EXCEPT IF BLOCK SPECIFIES SYSTEM 


STM 

14,11,12(13) 

SAVE REGISTERS 


LR 

10,15 

SET PROLOGUE BASE 


L 

11, STATIC (0,10) 

SET UP STATIC INTERNAL DATA POINTER 


L 

15,32(0,11) 

LOAD GR15 WITH ADDRESS OF IHESADA 


L 

0, SIZDSA (0 ,10) 

LOAD GR0 WITH SIZE OF DSA 


BALR 

14,15 

CALL IHESADA TO GET A DSA 


LR 

14,13 



LA 

0, 7(0,0) 



SR 

15,15 


LOOP 

A 

14,0(0,11) 

SET UP ADDRESSING VECTOR IN 


ST 

14, ADVEC+4 (15,13) 

DSA 


LA 

15,4(0,15) 



BCT 

0, LOOP (0,10) 



BC 

15, COMMON (0,10) 

BRANCH TO INITIALIZE DSA 


DC 

F' SIZE OF DSA' 



DC 

A (STATIC INTERNAL CONTROL SECTION) 

COMMON 

BALR 

10,0 


* 

CODE 

IS GENERATED HERE 

FOLLOWING SAME PATTERN AS FOR 


* A BEGIN PROLOGUE (SEE BELOW) COMMON SECTION. 

LA 10 , ONSTART 

ONSTART 


♦ EPILOGUE FOR AN ON BLOCK 

L 15 ,IHESAFA (0 , 11) LOAD GR15 WITH ENTRY POINT TO EPILOGUE 

BALR 14,15 ROUTINE AND BRANCH AND LINK TO IT 


* 

B 


LOOP 


PROLOGUE FOR A BEGIN BLOCK 

LA 14, BEND 

BALR 15,0 

CNOP 0,4 

STM 14,11,12(13) 

BALR 9,0 
L 15,32(0,11) 

L 0 , SIZDSA (0,9) 

BALR 14,15 
LR 14,13 
LA 0, 7(0,0) 

SR 15,15 
A 14,0(0,11) 

ST 14, ADVEC+4 (15,13) 

LA 15,4(0,15) 

BCT 0 , LOOP (0,9) 

BC 15, COMMON (0,9) 

DC F* SIZE OF DSA' 

LA 9 , ADDA REA (0,13) 


SET UP RETURN REGISTER 
SET UP ENTRY POINT ADDRESS 

SAVE REGISTERS IN CONTAINING BLOCK'S DSA 
SET UP PROLOGUE BASE 

LOAD GR15 WITH ENTRY POINT TO IHESADA 
GET A DSA 


SET UP ADDRESSING VECTOR FOR DSA 


SET GRG TO POINT TO ADDRESSING AREA 
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ST 9,ADVEC (0,13) AT END OF DSA AND STORE IN ADDRESSING 

VECTOR 

THE CODE GENERATED HERE IS THE SAME AS THAT FOR A PROCEDURE PROLOGUE 
EXCEPT THAT A DIFFERENT CODE BYTE IS MOVED TO THE FIRST BYTE OF THE 
DSA; GR10 IS NOT RESET; AND THE BCR 15 , 8 IS NOT GENERATED. 


* EPILOGUE OF A BEGIN BLOCK 

L 15, IHESAFA LOAD GR15 WITH ENTRY POINT OF 

BALR 14,15 EPILOGUING ROUTINE AND CALL IT 

BEND 


* RETURN (EXP) STATEMENT EXAMINES THE LOCATION 'SWITCH' IN THE DSA 

* SET BY THE PROLOGUE TO DETERMINE THE CONVERSION REQUIRED ON 

* THE EXPRESSION. IT THEN ASSIGNS THE CONVERTED EXPRESSION TO 

* THE TARGET FIELD FOR WHICH THE LOCATION 'TARGET', IN THE DSA, 

* POINTS TO EITHER ITS DOPE VECTOR (IN THE CASE OF A STRING) 

* OR THE STORAGE. ROUTINE IHESAFA IS THEN INVOKED. 

* END STATEMENT (WHICH IS THE SAME AS A RETURN STATEMENT) 

L 15, IHESAFA 

BALR 14,15 


DSA OPTIMIZATION 


In coirpilations specifying OPT=l, if a 
PROCEDURE or BEGIN block has a DSA which 
requires less than 512 bytes of storage, 
such storage may, under certain conditions, 
be obtained from STATIC storage or from 
library workspace. To obtain a STATIC DSA, 
the block must satisfy these conditions: 

1. The block must not be re-entrant or 
recursive 

2. The block must not be nested (at any 
depth) within an ON block 

3. The block must not have the MAIN or 
TASK options 

A block which is ineligible for a STATIC 
DSA, and whose DSA will never be active 
when any new DSA is required, is allocated 
its DSA from library workspace. 

Each block requiring a DSA either in 
STATIC or in library workspace calls one of 
two compiled subroutines, instead of 
IHESAD, to allocate the storage. Either or 
both subroutines, if required, are compiled 
onto the end of the program, and are 
prefixed by the comments ' STATIC PROLOGUE 
SUBROUTINE' and 'DYNAMIC PROLOGUE 
subroutine' respectively. Entry may be 
made to the STATIC prologue subroutine at 
one of several points. 

Any block using one of these prologue 
subroutines will also use a compiled 
Epilogue subroutine, which will be called 
for the END statement of the block, or for 
a RETURN statement without an expression. 


(The same Epilogue subroutine serves both 
STATIC and library workspace DSAs.) If 
there is any core to be freed, the Epilogue 
subroutine will call IHESAFA. The Epilogue 
subroutine is also compiled onto the end of 
the program, and always immediately 
precedes the STATIC Prologue subroutine if 
this is present. 


The address of the Dynamic Prologue 
subroutine and the Epilogue subroutine are 
placed in the STATIC internal control 
section, at offsets 40 and 48 from the 
start respectively. Since the STATIC 
Prologue subroutine always follows the 
Epilogue subroutine, which is of fixed 
length, a third address slot is not 
required for it. 

Listings of the Dynamic and Static 
Prologue and the Epilogue subroutines 

* DYNAMIC PROLOGUE SUBROUTINE 

L 5, PR. .IHEQLWF(12) 

LTR 5,5 

BC 8,90(15) 

L 6, PR. .IHEQINV(12) 

LTR 6,6 

BC 4,90(15) 

LR 13,5 

SR 2, 2 

L 3, PR. . IHEQSLA (12) 

ST 13, PR . . IHEQSLA (12) 

ST 3,4(13) 

TM 0(3),X'80* 

BC 1,52(15) 

L 3,4(3) 

B 36(15) 

ST 13,8(3) 

L 4, PR. .IHEQINV(12) 
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LA 

ST 


4,1(4) 

4, PR. .IHEQINVC12) 


ST 

4,84(13) 

L 

15, A. .IHESAFA 

ST 

2,80(13) 

BR 

15 

ST 

2,8(13) 



MVI 

76 (13), X* 00' 



ST 

2,96(13) 

* END 

SUBROUTINE 

BR 

14 



L 

15,32(11) 

* STATIC PROLOGUE SUBROUTINE 

BR 

15 

L 

4 , PR. • IHEQINV (12) 

END 

SUBROUTINE 

LTR 

4,4 



BC 

11,86(15) 

EPILOGUE SUBROUTINE 

L 

7, PR. • IHEQLWO(12) 



MVC 

80(4,3) ,80(7) 

TM 

1(13), X*80* 

LA 

4,1(4) 

BC 

8,60(15) 

ST 

4, PR. .IHEQINV (12) 

L 

2,80(13) 

ST 

4,84(3) 

LTR 

2,2 

MVI 

76 (3) ,X*00* 

BC 

7,60(15) 

ST 

3,8(13) 

C 

13,PR..IHEQSLA(12) 

LR 

13,3 

BC 

7,60(15) 

L 

3, PR. .IHEQSLA (12) 

L 

13,4(13) 

ST 

3,4(13) 

ST 

13, PR. . IHEQSLA (12) 

ST 

13, PR. .IHEQSLA (12) 

TM 

0(13), X f 80* 

SR 

2.2 

BC 

1,50(15) 

ST 

2,80(13) 

L 

13,4(13) 

ST 

2,8(13) 

B 

34(15) 

ST 

2,96(13) 

ST 

2,8(13) 

BR 

14 

LM 

14,11,12(13) 



BR 

14 

* END 

SUBROUTINE 
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APPENDIX I: DIAGNOSTIC MESSAGES 


The messages produced by the PL/I (F) 

IEM0061I 

Read 

In 

CP 

Compiler are explained in the publication 

IEM0063I 

Read 

In 

CO 

IBM Svstera/360 Operating System, PL/I (F) 

IEM0064I 

Read 

In 

CC 

Programmer* 

s Guide. 

The following table 

IEM0067I 

Read 

In 

CL 

associates 

a message 

number with the 

IEM0069I 

Read 

In 

CG 

particular 

phase 

and 

module in which the 

IEM0070I 

Read 

In 

CG 

corresponding message is generated. 

IEM0071I 

Read 

In 

CG 





IEM0072I 

Read 

In 

CG 

Message 




IEM0074I 

Read 

In 

CG 

Number 

Logical 

Phase Module 

IEM0075I 

Read 

In 

CG 





IEM0076I 

Read 

In 

CG 

IEM0001I 

Read 

In 

CA 

IEM0077I 

Read 

In 

CG 

IEM0002I 

Read 

In 

CA 

IEM0078I 

Read 

In 

CG 

IEM0003I 

Read 

In 

CA, CP 

IEM0080I 

Read 

In 

CG 

IEM0004I 

Read 

In 

CA 

IEM0081I 

Read 

In 

CG 

IEM0005I 

Read 

In 

CA, CL 1 

IEM0082I 

Read 

In 

Cl 

IEM0006I 

Read 

In 

CA 

IEM0083I 

Read 

In 

CG 

IEM0007I 

Read 

In 

CA 

IEM0084I 

Read 

In 

CG 

IEM0008I 

Read 

In 

CA 

IEM0085I 

Read 

In 

Cl 

IEM0009I 

Read 

In 

CA 

IEM0090I 

Read 

In 

Cl 

IEM0010I 

Read 

In 

CA 

IEM0094I 

Read 

In 

Cl 

IEM0011I 

Read 

In 

CA 

IEM0095I 

Read 

In 

Cl 

IEM0012I 

Read 

In 

CA 

IEM0096I 

Read 

In 

CG,CI 

IEM0013I 

Read 

In 

CA 

IEM0097I 

Read 

In 

Cl 

IEM0014I 

Read 

In 

CA 

IEM0099I 

Read 

In 

Cl 

IEM0015I 

Read 

In 

CA 

IEM0100I 

Read 

in 

Cl 

IEM0016I 

Read 

In 

CA 

IEM0101I 

Read 

In 

CM 

IEM0017I 

Read 

In 

CA 

IEM0102 I 

Read 

In 

Cl 

IEM0018I 

Read 

In 

CA 

IEM0103I 

Read 

In 

Cl 

IEM0019I 

Read 

In 

CA 

IEM0104I 

Read 

In 

CC 

IEM0020I 

Read 

In 

CA 

IEM0105I 

Read 

In 

CC, CG 

IEM0021I 

Read 

In 

CA 

IEM0106I 

Read 

In 

CI,CV 

IEM0022I 

Read 

In 

CA 

IEM0107I 

Read 

In 

Cl 

IEM0023I 

Read 

In 

CA 

IEM0108I 

Read 

In 

Cl 

IEM0024I 

Read 

In 

CA 

IEM0109I 

Read 

In 

CG, Cl 

IEM0025I 

Read 

In 

CA 

IEM0111I 

Read 

In 

Cl 

IEM0026I 

Read 

In 

CA 

IEM0112I 

Read 

In 

Cl 

IEM0027I 

Read 

In 

CA 

IEM0113I 

Read 

In 

CG,CM 

IEM0028I 

Read 

In 

CG 

IEM0114I 

Read 

In 

Cl 

IEM0029I 

Read 

In 

CA 

IEM0115I 

Read 

In 

CL 

IEM0031I 

Read 

In 

CA, CL, CT 

IEM0116I 

Read 

In 

Cl 

IEM0033I 

Read 

In 

CC 

IEM0117I 

Read 

In 

CM 

IEM0035I 

Read 

In 

CC 

IEM0118I 

Read 

In 

CL 

IEM0037I 

Read 

In 

CC 

IEM0119I 

Read 

In 

CM 

IEM0038I 

Read 

In 

CC 

IEM0120I 

Read 

In 

CM 

IEM0039I 

Read 

In 

CC 

IEM0121I 

Read 

In 

CO 

IEM0040I 

Read 

In 

CC 

IEM0122I 

Read 

In 

CO 

IEM0043I 

Read 

In 

CC 

IEM0123I 

Read 

In 

CM 

IEM0044I 

Read 

In 

CC 

IEM0124I 

Read 

In 

CO 

IEM0045I 

Read 

In 

CC 

IEM0125I 

Read 

In 

Cl 

IEM0046I 

Read 

In 

CC 

IEM0126I 

Read 

In 

Cl 

IEM0048I 

Read 

In 

CG 

IEM0127I 

Read 

In 

Cl 

IEM0050I 

Read 

In 

CL, CP 

IEM0128I 

Read 

In 

CO 

IEM0051I 

Read 

In 

CL, CP 

IEM0129I 

Read 

In 

CL 

IEM0052I 

Read 

In 

CO 

IEM0130I 

Read 

In 

CL 

IEM0053I 

Read 

In 

CO 

IEM0131I 

Read 

In 

CO 

IEM0054I 

Read 

In 

CO 

IEM0132I 

Read 

In 

CO 

IEM0055I 

Read 

In 

CP 

IEM0134I 

Read 

In 

CP 

IEM0057I 

Read 

In 

CC 1 

1 IEM0135I 

Read 

In 

CG ,CI 

IEM0058I 

Read 

In 

CC 

IEM0136I 

Read 

In 

CO 

IEM0059I 

Read 

In 

CP 

IEM0138I 

Read 

In 

CP 

IEM0060I 

Read 

In 

CP 

IEM0139I 

Read 

In 

CP 
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IEM0140I 

Read In 

CO 

IEM0514I 

Dictionary 

EG 

IEM0141I 

Read In 

CP 

IEM0515I 

Dictionary 

EG 

IEM0144I 

Read In 

CO 

IEM0516I 

Dictionary 

EG 

IEM0145I 

Read In 

CO 

IEM0517I 

Dictionary 

EG 

IEM0147I 

Read In 

CO 

IEM0518I 

Dictionary 

EG 

IEM0149I 

Read In 

CL, CM 

IEM0519I 

Dictionary 

EG 

IEM0150I 

Read In 

CL 

IEM0520I 

Dictionary 

EG 

IEM0151I 

Read In 

CO 

IEM0521I 

Dictionary 

EG 

IEM0152I 

Read In 

CO 

IEM0522I 

Dictionary 

EG 

IEM0153I 

Read In 

CO 

IEM0523I 

Dictionary 

EG 

IEM0154I 

Read In 

CA 

IEM0524I 

Dictionary 

EH 

IEM0158I 

Read In 

CO 

IEM0525I 

Dictionary 

El 

IEM0159I 

Read In 

CO 

IEM0527I 

Dictionary 

EJ 

IEM0163I 

Read In 

CT 

IEM0528I 

Dictionary 

EH, El, EJ 

IEM0166I 

Read In 

CL 

IEM0529I 

Dictionary 

El 

IEM0172I 

Read In 

CL 

| IEM0530I 

Dictionary 

El 

IEM0180I 

Read In 

CT 

IEM0532I 

Dictionary 

El 

IEM0181I 

Read In 

CL 

IEM0533I 

Dictionary 

El 

IEM0182I 

Read In 

CL,CS, 

IEM0534I 

Dictionary 

El 



CT, CV 

| IEM0535I 

Dictionary 

El 

IEM0185I 

Read In 

CT 

IEM0536I 

Dictionary 

El 

IEM0187I 

Read In 

CT 

IEM0537I 

Dictionary 

El 

IEM0191I 

Read In 

CT 

IEM0538I 

Dictionary 

EJ 

IEM0193I 

Read In 

CT 

IEM053 91 

Dictionary 

EJ 

IEM0194I 

Read In 

CT 

IEM0540I 

Dictionary 

EJ 

IEM0195I 

Read In 

CT 

IEM0541I 

Dictionary 

EJ 

IEM0198I 

Read In 

CT 

IEM0542I 

Dictionary 

EJ 

IEMG202I 

Read In 

CL 

IEM0543I 

Dictionary 

EL, EK, EM 

IEM0207I 

Read In 

CG 

IEM0544I 

Dictionary 

EL,EK,EM 

IEM0208I 

Read In 

CG 

IEM0545I 

Dictionary 

EL, EK, EM 

IEM0209I 

Read In 

CC 

IEM0546I 

Dictionary 

EL , EK , EM 

IEM0211I 

Read In 

CL 

IEM0547I 

Dictionary 

EL, EK, EM 

IEM0212I 

Read In 

CP 

IEM0548I 

Dictionary 

EL , EK , EM 

IEM0213I 

Read In 

CP 

IEM0549I 

Dictionary 

EL, EK, EM 

IEM0214I 

Read In 

CP 

IEM0550I 

Dictionary 

EL,EK,EM 

IEM0216I 

Read In 

CP 

IEM0551I 

Dictionary 

EK,EL,EM 

IEM0217I 

Read In 

CP 

IEH0552I 

Dictionary 

EL , EK , EM 

IEM0220I 

Read In 

CT 

IEM0553I 

Dictionary 

EL,EK,EM 

XEM0221I 

Read In 

CT 

IEH0554I 

Dictionary 

EL , EEC , EM 

IEM0222I 

Read In 

CT 

IEM0555I 

Dictionary 

EL , EK , EM 

IEM0223I 

Read In 

CT 

IEM0556I 

Dictionary 

EL,EK, EM 

IEM0224I 

Read In 

CT 

IEM0557I 

Dictionary 

EL ,EK, EM 

IEM0225I 

Read In 

CT 

IEM0558I 

Dictionary 

EL, EK, EM 

IEM0226I 

Read In 

CT 

IEM0559I 

Dictionary 

EL,EK,EM 

IEM0227I 

Read In 

CT 

IEM0560I 

Dictionary 

EL,EK,EM 

IEM0228I 

Read In 

CT 

IEM0561I 

Dictionary 

EL, EK, EM 

IEM0229I 

Read In 

CT 

IEM0562I 

Dictionary 

EK,EL,EM 

IEM0230I 

Read In 

CS,CT 

IEM0563I 

Dictionary 

EK , EL, EM 

IEM0231I 

Read In 

CT 

IEM0564I 

Dictionary 

EK,EL,EM 

IEM0232I 

Read In 

CT 

IEM0565I 

Dictionary 

EK,EL, EM 

IEM0233I 

Read In 

CV 

IEM0566I 

Dictionary 

EK ,EL,EM 

IEM0235I 

Read In 

CS 

IEM0567I 

Dictionary 

EP 

IEM0236I 

Read In 

CS 

IEM0568I 

Dictionary 

EP 

IEM0237I 

Read In 

CS 

IEM0569I 

Dictionary 

EP 

IEM0238I 

Read In 

CV 

IEM0570I 

Dictionary 

EP 

IEM0239I 

Read In 

CS 

IEM0571I 

Dictionary 

EK 

IEM0240I 

Read In 

CV 

IEM0572I 

Dictionary 

EL 

IEM0241I 

Read In 

CV 

IEM0573I 

Dictionary 

EL 

IEM0242I 

Read In 

CV I 

| IEM0576I 

Dictionary 

RT. 

IEM0243I 

Read In 

CV 

IEM0577I 

Dictionary 

EL 

IEM0244I 

Read In 

CV 

IEM0578I 

Dictionary 

EL 

IEM0245I 

Read In 

CV 

IEM0579I 

Dictionary 

EP 

IEM0247I 

Read In 

cw 

IEM0580I 

Dictionary 

FI 

IEM0254I 

Read In 

CC 

IEM0589I 

Dictionary 

EW 

IEM0255I 

Read In 

CG 

IEM0590I 

Dictionary 

EW 

IEM0510I 

Dictionary 

EH 

IEM0591I 

Dictionary 

EW 

IEM0511I 

Dictionary 

EH 

IEM0592I 

Dictionary 

EW 

IEM0512I 

Dictionary 

EH 

IEM0593I 

Dictionary 

EW 

IEM0513I 

Dictionary 

EG 

IEM0594I 

Dictionary 

EW 
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IEM0595I 

Dictionary 

EW 

IEM0698I 

Dictionary 

FI 


IEM0596I 

Dictionary 

EW 

IEM0699I 

Dictionary 

FI 


IEM0597I 

Dictionary 

EW 

IEM0700I 

Dictionary 

FI 


IEM0598I 

Dictionary 

EW 

I EM 07011 

Dictionary 

FI 


IEM0599I 

Dictionary 

EW 

IEM0702I 

Dictionary 

FI 


IEM0602I 

Dictionary 

FV,FW 

IEM0703I 

Dictionary 

FI 


IEM0603I 

Dictionary 

FV # FW 

IEM0704I 

Dictionary 

FI 


IEM0604I 

Dictionary 

FV,FW 

IEM07051 

Dictionary 

FI 


IEM06052 

Dictionary 

FV,FW 

IEM0706I 

Dictionary 

FI 


IEM0606I 

Dictionary 

FV, FW 

UEM0707I 

Dictionary 

FI 


IEM0607I 

Dictionary 

FV,FW 

IEM0715I 

Dictionary 

EJ 


IEM0608I 

Dictionary 

FV, FW 

IEM0718I 

Dictionary 

FO 


IEM0609I 

Dictionary 

FV, FW 

IEM0719I 

Dictionary 

FO 


IEM0610I 

Dictionary 

FV, FW 

IEM0720I 

Dictionary 

FO 


IEM0611I 

Dictionary 

FV, FW 

IEM0721I 

Dictionary 

FO 


IEM0612I 

Dictionary 

FV 

IEM0722I 

Dictionary 

FO 


IEM0613I 

Dictionary 

FW 

IEM0723I 

Dictionary 

FO 


IEM0614I 

Dictionary 

FW 

IEM0724I 

Dictionary 

FO 


IEM0623I 

Dictionary 

FV, FW 

IEM0725I 

Dictionary 

FO 


IEM0624I 

Dictionary 

FV, FW 

IEM0726I 

Dictionary 

FO 


IEM0625I 

Dictionary 

FV, FW 

IEM0727I 

Dictionary 

FO 


IEM0626I 

Dictionary 

FV,FW 

IEM0728I 

Dictionary 

FO 


IEM0628I 

Dictionary 

FV, FW 

IEM0729I 

Dictionary 

FO 


IEM0629I 

Dictionary 

FV, FW 

IEM0730I 

Dictionary 

FQ 


IEM0630I 

Dictionary 

FV, FW 

IEM0731I 

Dictionary 

FQ 


IEMO 6311 

Dictionary 

FV, FW 

IEM0732I 

Dictionary 

FQ 


IEM0632I 

Dictionary 

FV,FW 

IEM0733I 

Dictionary 

FQ 


IEM0633I 

Dictionary 

EY 

IEM0734I 

Dictionary 

FQ 


IEM0634I 

Dictionary 

EY 

IEM0735I 

Dictionary 

FQ 


IEM0636I 

Dictionary 

EY 

IEM0736I 

Dictionary 

FQ 


IEM0637I 

Dictionary 

EY 

IEM0737I 

Dictionary 

FQ 


IEM0638I 

Dictionary 

EY 

IEM0739I 

Dictionary 

FQ 


IEM0640I 

Dictionary 

EY 

IEM0740I 

Dictionary 

FQ 


IEM0641I 

Dictionary 

EY 

IEM0741I 

Dictionary 

FQ 


IEMO 6 421 

Dictionary 

EY 

IEM0742I 

Dictionary 

FQ 


IEM0643I 

Dictionary 

EY 

IEM0745I 

Dictionary 

FQ 


IEMO 6441 

Dictionary 

EY 

IEM0746I 

Dictionary 

FQ 


IEM0645I 

Dictionary 

EY 

IEM0747I 

Dictionary 

FQ 


IEMO 6 4 61 

Dictionary 

EY 

IEM0748I 

Dictionary 

FQ 


IEM0647I 

Dictionary 

EY 

IEM0749I 

Dictionary 

FQ 


IEM0653I 

Dictionary 

FE 

IEM0750I 

Dictionary 

FQ 


IEM0655I 

Dictionary 

FE 

IEM0751I 

Dictionary 

FQ 


IEM0656I 

Dictionary 

FE 

IEM0752I 

Dictionary 

FQ 


IEM0657I 

Dictionary 

FE 

IEM0754I 

Dictionary 

FQ 


IEM0658I 

Dictionary 

FE 

IEM0755I 

Dictionary 

FQ 


IEMO 6601 

Dictionary 

FE 

IEM0756I 

Dictionary 

FQ 


IEMO 6 611 

Dictionary 

FE 

IEM0758I 

Dictionary 

FQ 


IEM0662I 

Pretranslator 

GV 

IEM0759I 

Dictionary 

FQ 


IEM0673I 

Dictionary 

FE 

IEM0760I 

Dictionary 

FQ 


IEM0674I 

Dictionary 

FF 

IEM0761I 

Dictionary 

FQ 


IEM0675I 

Dictionary 

FF 

IEM0762I 

Dictionary 

FQ 


IEM0676I 

Dictionary 

FF 

IEM0769I 

Pretranslator 

GB 


IEMO 6771 

Dictionary 

FE 

IEM0770I 

Pretranslator 

GB 


IEM0682I 

Dictionary 

FI 

IEM0771I 

Pretranslator 

GB 


IEMO 6831 

Dictionary 

FI 

IEM0778I 

Pretranslator 

GB 


IEM0684I 

Dictionary 

FI 

IEM0779I 

Pr etrans lator 

GB 


IEMO 6 851 

Dictionary 

FI 

IEM0780I 

Pretranslator 

GB 


IEM0686I 

Dictionary 

FI 

IEM0781I 

Pretranslator 

GB 


IEM0687I 

Dictionary 

FI 

IEM0782I 

Pretranslator 

GB 


IEMO 6 8 81 

Dictionary 

FI 

IEM0786I 

Pretranslator 

GK 


IEM0689I 

Dictionary 

FI 

IEM0787I 

Pretranslator 

GK 


IEMO 6 901 

Dictionary 

FI 

IEM0791I 

Pretranslator 

GK 


IEM0691I 

Dictionary 

FI 

IEM0792I 

Pre translator 

GP, 

GQ, GR 

IEM0692I 

Dictionary 

FI 

IEM0793I 

Pre translator 

GP, 

GQ,GR 

IEM0693I 

Dictionary 

FI 

IEM0794I 

Pretranslator 

GP, 

GQ,GR 

IEMO 6 941 

Dictionary 

FI 

IEM0795I 

Pretranslator 

GP, 

GQ,GR 

IEM0695I 

Dictionary 

FI 

IEM0796I 

Pretranslator 

GP, 

GQ,GR 

IEM0696I 

Dictionary 

FI 

IEM0797I 

Pretranslator 

GP, 

GQ,GR 

IEM0697I 

Dictionary 

FI 

IEM0798I 

Pretranslator 

GP, 

GQ,GR 
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IEM0799I 

Pretranslator 

GP ( GQ ( GR 

IEM3052I 

Compiler Control 

AL/AN 

IEH0800I 

Pretranslator 

GP V GQ,GR 

IEM3842I 

Compiler Control 

AL/AN 

IEM0801I 

Pretranslator 

GP*GQ f GR 

IEM3843I 

Compiler Control 

AL/AN 

IEM0802I 

Pretranslator 

GP r GQ,GR 

IEM3845I 

Compiler Control 

AL/AN 

IEM0803I 

Pretranslator 

gp,gq # gr 

IEM3846I 

Compiler Control 

AL/AN 

IEM0804I 

Pretranslator 

GP ( GQ,GR 

IEM3847I 

Compiler Control 

AL/AN 

IEM0805I 

Pretranslator 

GP, GQ.GR 

IEM3848I 

Compiler Control 

AL/AN 

| IEM0808I 

Pretranslator 

GR 
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IEM0806I 

Pretranslator 

GP,GQ,GR 

IEM1061I 

Translator 

IM 

IEM0807I 

Pretranslator 

GP,GQ,GR 

IEM1062I 

Translator 

IM 

IEM0816I 

Pretranslator 

GU,GV 

IEM1063I 

Translator 

IM 

IEM0817I 

Pretranslator 

GU,GV 

IEM1064I 

Translator 

IM 

IEM0818I 

Pretranslator 

GU, GV 

IEM1065I 

Translator 

IM 

IEM0819I 

Pretranslator 

GU,GV 

IEM1066I 

Translator 

IM 

IEM0820I 

Pretranslator 

GU, GV 

IEM1067I 

Translator 

IM 

IEM0821I 

Pretranslator 

GU, GV 

IEM1068I 

Translator 

IM 

IEM0823I 

Pretranslator 

GU, GV 1 

IEM1070I 

Translator 

IM 

IEM0824I 

Pretranslator 

GU 

IEM1071I 

Translator 

IM 

IEM0825I 

Pretranslator 

GU,GV 

IEM1072I 

Translator 

IM 

IEM0826I 

Pretranslator 

GU, GV 

IEM1073I 

Translator 

IM 

IEM0832I 

Pretranslator 

HF, HG 

IEM1074I 

Translator 

IM 

IEM0833I 

Pretranslator 

HF, HG 

IEM1076I 

Translator 

JD 

IEM0834I 

Pretranslator 

HF, HG 

IEM1082I 

Translator 

IX 

IEM0835I 

Pretranslator 

HF, HG 

IEM1088I 

Aggregates 

JK 

IEM0836I 

Pretranslator 

HF, HG 

IEM1089I 

Aggregates 

JK 

IEM0837I 

Pretranslator 

HF, HG 

IEM1090I 

Aggregates 

JK 

IEM0838I 

Pretranslator 

HF 

IEM1091I 

Aggregate Preprocessor 

JI 

IEM0848I 

Pretranslator 

HF, HG 

IEM1092I 

Aggregates 

JK 

IEM0849I 

Pretranslator 

HF, HG 

IEM1104I 

Aggregates 

JP 

IEM0850I 

Pretranslator 

HF, HG 

IEM1105I 

Aggregates 

JP 

IEM0851I 

Pretranslator 

HF, HG 

IEM1106I 

Aggregates 

JP 

IEM0852I 

Pretranslator 

HF, HG 

IEM1107I 

Aggregates 

JP 

IEM0853I 

Pret rans lator 

HF, HG 

IEM1108I 

Aggregates 

JP 

IEM0864I 

Pretranslator 

HK,HL 

IEM1110I 

Aggregates 

JP 

IEM0865I 

Pretranslator 

HK,HL 

IEMllllI 

Aggregates 

JP 

IEM0866I 

Pretr ans lator 

HK,HL 

IEM1112I 

Aggregates 

JP 

IEM0867I 

Pretranslator 

HK, HL 

IEM1113I 

Aggregates 

JP 

IEM0868I 

Pretranslator 

HK,HL 

IEM1114I 

Aggregates 

JP 

IEM0869I 

Pretranslator 

HK, HL 

IEM1115I 

Aggregates 

JP 

IEM0870I 

Pretranslator 

HK, HL 

IEM1120I 

Aggregates 

JP 

IEM0871I 

Pretranslator 

HK, HL 

IEM1121I 

Aggregates 

JP 

IEM0872I 

Pretranslator 

HK, HL 

IEM1122I 

Aggregates 

JP 

IEM0873I 

Pretranslator 

HK, HL 

IEM1123I 

Pseudo- code 

LD 

IEM0874I 

Pretranslator 

HK, HL 

IEM1125I 

Pseudo- code 

LD 

IEM0875I 

Pretranslator 

HK, HL 

IEM1200I 

Pseudo- code 

KT 

IEM0876I 

Pretranslator 

HK, HL 

1 IEM1210I 

Do loop optimization 

KC 

IEM0877I 

Pretranslator 

HK, HL 

1 IEM1211I 

Do loop optimization 

KE 

IEM0878I 

Pretranslator 

HK, HL 

IEM1220I 

Do loop optimization 

KU 

IEM0879I 

Pretranslator 

HK, HL 

IEM1223I 

Do loop optimization 

KO 

IEM0880I 

Pretranslator 

HK, HL 

IEM1224I 

Do loop optimization 

KA 

IEM0881I 

Pretranslator 

HK, HL 

IEM1569I 

Pseudo-code 

LG-ON 

IEM0882I 

Pretrans lator 

HK 

IEM1570I 

Ps eu do- code 

LG 

IEM0896I 

Pretrans lator 

HP 

IEM1571I 

Pseudo-code 

LG 

IEM0897I 

Pretrans lator 

HP 

IEM1572I 

Pseudo- code 

LG 

IEM0898I 

Pretranslator 

HP 

IEM1574I 

Pseudo- code 

LG 

IEM0899I 

Pretranslator 

HP 

IEM1575I 

Pseudo- code 

LG 

IEM0900I 

Pretranslator 

HP 

IEM1588I 

Pseudo- code 

MD 

IEM0901I 

Pretranslator 

HP 

IEM1600I 

Pseudo-code 

LS,LT,LU 

IEM0902I 

Pretranslator 

HP 

IEM1601I 

Pseudo- code 

LS 

IEM0903I 

Pretranslator 

HP 

IEM1602I 

Pseudo-code 

LS,LT, LU 

IEM0906I 

Pretranslator 

HP 

IEM1603I 

Pseudo- code 

LS, LT, LU 

IEM0907I 

Pretranslator 

HP 

IEM1604I 

Pseudo-code 

LS,LT,LU 

IEM1024I 

Translator 

IA 

IEM1605I 

Pseudo- code 

LS, LT, LU 

IEM1025I 

Translator 

IA 

IEM1606I 

Pseudo-code 

LS , LT, LU 

IEM1026I 

Translator 

IA 

IEM1607I 

Pseudo- code 

LS,LT,LU 

IEM1027I 

Translator 

IA 

IEM1608I 

Pseudo- code 

LS,LT,LU 

IEM1028I 

Translator 

IA 

IEM1609I 

Pseudo-code 

LS , LT, LU 

IEM1029I 

Translator 

IA 

IEM1610I 

Pseudo- code 

LW 

IEM1030I 

Translator 

IA 

IEM1611I 

Pseudo-code 

LW 

IEM1040I 

Translator 

IM 

IEM1612I 

Pseudo- code 

LW 

IEM1051I 

Translator 

IM 

IEM1613I 

Pseudo-code 

LS , LT, LU 

I EMI 0561 

Translator 

IM 

IEM1614I 

Pseudo- code 

LW 

IEM1057I 

Translator 

IM 

IEM1615I 

Pseudo-code 

ME 

IEM1058I 

Translator 

IM 

IEM1616I 

Pseudo- code 

ME 

IEM1059I 

Translator 

IM 

IEM1617I 

Pseudo- code 

MB 

IEM1060I 

Translator 

IM 

IEM1618I 

Pseudo- code 

MB 
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IEM1619I 

Pseudo- code 

MB 

IEM1811I 

Pseudo-code 

OS 

IEM1620I 

Pseudo-code 

MB 

IEM1812I 

Pseudo- code 

os 

IEM1621I 

Pseudo- code 

MB 

IEM1813I 

Pseudo-code 

os 

IEM1622I 

Pseudo-code 

MB, ME 

IEM1814I 

Pseudo- code 

os 

IEM1624I 

Pseudo- code 

MB 

IEM1815I 

Pseudo-code 

os 

IEM1625I 

Pseudo-code 

MB 

IEM1816I 

Pseudo- code 

NJ 

IEM1626I 

Pseudo- code 

ME 

IEM1817I 

Pseudo- code 

NJ 

IEM1627I 

Pseudo-code 

ME 

IEM1818I 

Pseudo-code 

NJ 

IEM1628I 

Pseudo-code 

ME 

IEM1819I 

Pseudo- code 

NJ 

IEM1629I 

Pseudo- code 

ME 

IEM1820I 

Pseudo-code 

NJ 

IEM1630I 

Pseudo-code 

MG,MH 

IEM1821I 

Pseudo- code 

NJ 

IEM1631I 

Pseudo-code 

MI, MJ 

IEM1822I 

Pseudo-code 

NJ 

IEM1632I 

Pseudo-code 

MI , MJ 

IEM1823I 

Pseudo- code 

NJ 

IEM1633I 

Pseudo- code 

ME 

IEM1824I 

Pseudo-code 

NM 

IEM1634I 

Pseudo-code 

ME 

IEM1825I 

Pseudo- code 

NG 

IEM1635I 

Pseudo- code 

ME 

IEM1826I 

Pseudo- code 

NG 

IEM1636I 

Pseudo-code 

ME 

IEM1827I 

Pseudo- code 

NG 

IEM1637I 

Pseudo- code 

ME 

IEM1828I 

Pseudo- code 

NG 

IEM1638I 

Pseudo- code 

ME 

IEM1829I 

Pseudo-code 

NG 

IEM1639I 

Pseudo- code 

MF 

IEM1830I 

Pseudo- code 

NG 

IEM1640I 

Pseudo- code 

MM, MN 

1 IEM1831I 

Pseudo-code 

NJ 

IEM1641I 

Pseudo-code 

MM, MN 

IEM1832I 

Pseudo- code 

NM 

IEM1642I 

Pseudo- code 

MM, MN 

IEM1833I 

Pseudo-code 

NM 

IEM1643I 

Pseudo-code 

MM,MN 

IEM1834I 

Pseudo- code 

NM 

IEM1644I 

Pseudo- code 

MM, MN 

IEM1835I 

Pseudo-code 

NM 

IEM1645I 

Pseudo-code 

MM, MN 

IEM1836I 

Pseudo- code 

NM 

IEM1648I 

Pseudo- code 

MM, MN 

IEM1837I 

Pseudo- code 

NM 

IEM1649I 

Pseudo-code 

MM, MN 

IEM1838I 

Pseudo-code 

NM 

IEM1650I 

Pseudo-code 

MM, MN 

IEM1839I 

Pseudo- code 

NM 

IEM1651I 

Pseudo-code 

MM, MN 

IEM1840I 

Pseudo-code 

NM 

IEM1652I 

Pseudo-code 

MM, MN 

IEM1841I 

Pseudo- code 

NM 

IEM1654I 

Pseudo- code 

MM, MN 

IEM1843I 

Pseudo-code 

NM 

IEM1655I 

Pseudo-code 

MN 

IEM1844I 

Pseudo- code 

NM 

IEM1656I 

Pseudo- code 

ME 

IEM1845I 

Pseudo-code 

NM 

IEM1657I 

Pseudo-code 

MM 

IEMX846I 

Ps eudo- code 

NM 

| IEM1658I 

Pseudo- code 

MN 

IEM1847I 

Pseudo- code 

NM 

IEM1670I 

Pseudo-code 

MP 

IEM1848I 

Pseudo- code 

NM 

IEM1671I 

Pseudo- code 

MP 

IEM1849I 

Constant Conversions 

os 

IEM1680I 

Pseudo-code 

MS 

IEM1850I 

Constant Conversions 

OS 

IEM1687I 

Pseudo-code 

MS 

IEM1860I 

Pseudo- code 

NU 

IEM1688I 

Pseudo- code 

MS 

IEM1861I 

Pseudo- code 

NU 

IEM1689I 

Pseudo-code 

MS 

IEM1862I 

Pseudo- code 

NU 

IEM1692I 

Pseudo- code 

MS 

IEM1870I 

Pseudo-code 

NU 

IEM1693I 

Pseudo-code 

MS 

IEM1871I 

Pseudo- code 

NU 

IEM1695I 

Pseudo-code 

MA 

IEM1872I 

Pseudo-code 

NU 

IEM1696I 

Pseudo-code 

MA 

IEM1873I 

Pseudo- code 

NU 

IEM1750I 

Pseudo- code 

MS 

IEM1874I 

Pseudo- code 

NU 

IEM1751I 

Pseudo-code 

MS 

IEM1875I 

Pseudo-code 

NV 

IEM1752I 

Pseudo- code 

NA 

IEM2304I 

storage Allocation 

PD 

IEM1753I 

Pseudo-code 

NA 

IEM2305I 

Storage Allocation 

PD 

IEM1754I 

Pseudo-code 

NA 

IEM2352I 

Storage Allocation 

PD 

IEM1790I 

Pseudo- code 

OG, OM 

IEM2650I 

Register Allocation 

RA 

IEM1793I 

Pseudo-code 

OE 

IEM2660I 

Register Allocation 

RD 

IEM1794I 

Pseudo- code 

OE 

IEM2661I 

Register Allocation 

RD 

IEM1795I 

Pseudo-code 

OE 

IEM2700I 

Register Allocation 

RF,RG, RH 

IEM1796I 

Pseudo-code 

OE 

IEM2701I 

Register Allocation 

RF,RG, RH 

IEM1797I 

Pseudo- code 

OE 

IEM2702I 

Register Allocation 

RF,RG, RH 

IEM1800I 

Pseudo- code 

OS 

IEM2703I 

Register Allocation 

RF,RG,RH 

IEM1801I 

Pseudo-code 

OS 

IEM2704I 

Register Allocation 

RF,RG, RH 

IEM1802I 

Pseudo- code 

OS 

IEM2705I 

Register Allocation 

RF , RG , RH 

IEM1803I 

Pseudo- code 

OS 

IEM2706I 

Register Allocation 

RF,RG,RH 

IEM1804I 

Pseudo-code 

OS 

IEM2707I 

Register Allocation 

RF,RG, RH 

IEM1805I 

Pseudo- code 

OS 

IEM2708I 

Register Allocation 

RF,RG, RH 

IEM1806I 

Pseudo- code 

OS 

IEM2709I 

Register Allocation 

RF,RG, RH 

IEM1807I 

Pseudo-code 

OS 

IEM2710I 

Register Allocation 

RF , RG , RH 

IEM1808I 

Pseudo- code 

OS 

IEM2711I 

Register Allocation 

RF,RG, RH 

IEM1809I 

Pseudo- code 

OS 

IEM2712I 

Register Allocation 

RF , RG , RH 

IEM1810I 

Pseudo-code 

OS 

IEM2817I 

DCB Generation 

GA 
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IEM2818I 

DCB Generation 

GA 

IEM3845I 

Compiler Control 

AA 

IEM2819I 

DCB Generation 

GA 

IEM3846I 

Compiler Control 

AA 

IEM2820I 

DCB Generation 

GA 


Optimization 

KA 

IEM2821I 

DCB Generation 

GA 

IEM3847I 

Compiler Control 

AA 

IEM2822I 

DCB Generation 

GA 

IEM3848I 

Compiler Control 

AA 

IEM2823I 

DCB Generation 

GA 

IEM3849I 

Compiler Control 

AA 

IEM2824I 

DCB Generation 

GA 

IEM3850I 

Compiler Control 

AA 

IEM2825I 

DCB Generation 

GA 

IEM3851I 

Compiler Control 

AA 

IEM2826I 

DCB Generation 

GA 

IEM3852I 

Compiler Control 

AA 

IEM2827I 

DCB Generation 

GA 

IEM3853I 

Compiler Control 

AA 

IEM2828I 

DCB Generation 

GA 

IEM3855I 

Compiler Control 

AA 

IEM2829I 

DCB Generation 

GA 

IEM3856I 

Compiler Control 

AA 

IEM2830I 

DCB Generation 

GA 

IEM3857I 

Compiler Control 

AA 

IEM2831I 

DCB Generation 

GA 

IEM3858I 

Compiler Control 

AA 

IEM2832I 

DCB Generation 

GA 

IEM3859I 

Compiler Control 

AA 

IEM2833I 

Final Assembly 

TF 

IEM3860I 

Compiler Control 

AA 

IEM2834I 

Final Assembly 

TF 

IEM3861I 

Compiler Control 

AA 

IEM2835I 

Final Assembly 

TF 

IEM3862I 

Compiler Control 

AA 

IEM2836I 

Final Assembly 

TF 

IEM3863I 

Compiler Control 

AA 

IEM2837I 

Final Assembly 

TF 

IEM3864I 

Compiler Control 

AA 

IEM2852I 

Final Assembly 

TJ 

IEM3865I 

Compiler Control 

AA 

IEM2853I 

Final Assembly 

TJ 

| IEM3866I 

Compiler Control 

AA 

IEM2854I 

Final Assembly 

TJ 

IEM3872I 

Compiler Control 

AA 

IEM2855I 

Final Assembly 

TJ 

IEM3873I 

Compiler Control 

AA 

IEM2865I 

Final Assembly 

TO 

IEM3874I 

Compiler Control 

AA 

IEM2866I 

Final Assembly 

TO 

j IEM3875I 

Compiler Control 

AB 

IEM2867I 

Final Assembly 

TO 

IEM3876I 

Compiler Control 

AA 

IEM2868I 

Final Assembly 

TO 

| IEM3877I 

Compiler Control 

AB 

IEM2881I 

Final Assembly 

TT 

IEM3878I 

Compiler Control 

AA 

IEM2882I 

Final Assembly 

TT 

IEM3880I 

Compiler Control 

AA 

IEM2883I 

Final Assembly 

TT 

IEM3887I 

Compiler Control 

AA 

IEM2884I 

Final Assembly 

TT 

IEM3888I 

Compiler Control 

AB 

IEM2885I 

Final Assembly 

TT 

IEM3889I 

Compiler Control 

AB 

IEM2886I 

Final Assembly 

TT 

IEM3890I 

Compiler Control 

AA 

IEM2887I 

Final Assembly 

TT 

IEM3891I 

Compiler Control 

AA 

IEM2888I 

Final Assembly 

TT 

IEM3892I 

Compiler Control 

AA 

IEM2897I 

Final Assembly 

UA 

IEM3893I 

Compiler Control 

AA 

IEM2898I 

Final Assembly 

UA 

IEM3894I 

Compiler Control 

AA 

IEM2899I 

Final Assembly 

UC 

IEM3895I 

Compiler Control 

AA 

IEM2900I 

Final Assembly 

UC 

IEM3896I 

Compiler Control 

AA 

IEM2913I 

Final Assembly 

UF 

IEM3897I 

Compiler Control 

AA 

IEM3088I 

Dictionary, Declare 

EL 

IEM3898I 

Compiler Control 

AA 


Pass 2 


IEM3899I 

Compiler Control 

AL 

IEM3136I- 

Dictionary, Declare 

EL 

IEM3900I 

Compiler Control 

AB 

31491 

Pass 2 


IEM3901I 

Compiler Control 

AB 

IEM3151I 

Dictionary, Declare 

EL 

IEM3902I 

Compiler Control 

AB 


Pass 2 


IEM3902I 

Compiler Control 

AB 

IEM3153I 

Dictionary, Declare 

EL 

IEM3903I 

Compiler Control 

AB 


Pass 2 


IEM3904I 

Compiler Control 

AA 

IEM3154I 

Dictionary, Declare 

EL 

IEM3905I 

compiler Control 

AA 


Pass 2 


IEM3906I 

Compiler Control 

AA 

IEM3156I 

Dictionary, Declare 

EL 

IEM3907I 

Compiler Control 

AA 


Pass 2 


IEM3908I 

Compiler Control 

AA 

IEM3162I 

Dictionary, Declare 

EL 

IEM3909I 

Compiler Control 

AL 


Pass 2 


IEM3910I 

Compiler Control 

AB 

IEM3167I- 

Dictionary, Declare 

EL 

IEM3911I 

Compiler Control 

AB 

31731 

Pass 2 


IEM3912I 

Compiler Control 

AB 

IEM3176I- 

Dictionary, Declare 

EL 

IEM3913I 

Compile-time Processor 

AB 

31901 

Pass 2 


IEM3914I 

Compile-time Processor 

AB 

IEM3199I- 

Dictionary, Declare 

EL 

IEM4106I 

Compile-time Processor 

AS 

32131 

Pass 2 


IEM4109I 

Compile-time Processor 

AS 

IEM3584I 

48 Character 

BX 

IEM4112I 

Compile-time Processor 

AS 


Preprocessor 


IEM4115I 

Compile-time Processor 

AS 

IEM3840I 

Compiler Control 

AA 

IEM4118I 

Compile-time Processor 

AS 

IEM3841I 

Compiler Control 

AA 

IEM4121I 

Compile-time Processor 

AS , BC , BG 

IEM3842I 

Compiler Control 

AA 

IEM4124I 

Compile-time Processor 

BC, BG 

IEM3843I 

Compiler Control 

AA 

IEM4130I 

Compile-time Processor 

BG 

IEM3844I 

Compiler Control 

AA 

IEM4133I 

Compile-time Processor 

BC 
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IEM4134I Compile-time Processor BC 
IEM4136I Compile-time Processor BC 
IEM4139I Compile-time Processor BC 
IEM4142I Compile-time Processor BC 
IEM4143I Compile-time Processor BC 
IEM4148I Compile-time Processor BC 
IEM4150I Compile- time Processor BC 
IEM4151I Compile-time Processor BC 
IEM4152I Compile-time Processor BC 
IEM4153I Compile-time Processor BC 
IEM4154I Compile-time Processor BC 
IEM4157I Compile-time Processor BC 
IEM4160I Compile-time Processor BC 
IEM4163I Compile-time Processor BC 
IEM4166I Compile-time Processor BC 
IEM4169I Compile-time Processor BC 
IEM4172I Compile-time Processor BC 
IEM4175I Compile-time Processor BC 
IEM4176I Compile-time Processor BC 
IEM4178I Compile-time Processor BC 
IEM4184I Compile-time Processor BC 
IEM4187I Compile-time Processor BC 
IEM4188I Compile-time Processor BC 
IEM4190I Compile-time Processor BC 
IEM4193I Compile-time Processor BC 
IEM4196I Compile-time Processor BC 
IEM4199I Compile-time Processor BC 
IEM4202I Compile-time Processor BC 
IEM4205I Compile-time Processor BC 
IEM4208I Compile-time Processor BC 
IEM4211I Compile-time Processor BC 
IEM4212I Compile-time Processor BC 
IEM4214I Compile- time Processor BC 
IEM4215I Compile-time Processor BC 
IEM4217I Compile-time Processor BC 
IEM4220I Compile-time Processor BC 
IEM4223I compile-time Processor BC 
IEM4226I Compile-time Processor BC 
IEM4229I Compile- time Processor BC 
IEM4232I Compile-time Processor BC 
IEM4235I Compile-time Processor BC 
IEM4238I Compile-time Processor BC 
IEM4241I Compile- time Processor BC 
IEM4244I Compile- time Processor BC 
IEM4247I Compile-time Processor BC 
IEM4248I Compile-time Processor BC 
IEM4250I Compile- time Processor BC 
IEM4253I Compile-time Processor BC 
IEM4254I Compile-time Processor BC 
IEM4256I Compile-time Processor BC 
IEM4259I Compile- time Processor BC 
IEM4262I Compile-time Processor BC 
IEM4265I Compile-time Processor BC 
IEM4271I Compile-time Processor BC 
IEM4277I Compile-time Processor BC 
IEM4280I Compile-time Processor BC 
IEM4283I Compile-time Processor BC 
IEM4286I Compile-time Processor BC 
IEM4289I Compile-time Processor BC 
IEM4292I Compile-time Processor BC 
IEM4295I Compile-time Processor BC 
IEM4296I Compile-time Processor BC 
IEM4298I Compile-time Processor BC 
IEM4299I compile-time Processor BC 
IEM4301I Compile-time Processor BC 
IEM4304I Compile-time Processor BC 
IEM4307I Compile- time Processor BC 
IEM4310I Compile-time Processor BC 


IEM4313I Compile-time Processor BC 

IEM4319I Compile-time Processor BC 

IEM4322I Compile-time Processor BC 

IEM4325I Compile-time Processor BC 

| IEM4326I Compile-time Processor AV 

IEM4328I Compile-time Processor BC 

IEM4331I Compile-time Processor BC 

IEM43321 Compile-time Processor BC 

IEM4334I Compile-time Processor BC 

IEM4337I Compile-time Processor BC 

IEM4340I Compile-time Processor BC 

IEM4343I Compile-time Processor BC 

IEM4346I Compile-time Processor BC 

IEM4349I Compile-time Processor BC 

IEM4352I Compile-time Processor BC 

IEM4355I Compile-time Processor BC 

IEM4358I Compile-time Processor BC 

IEM4361I Compile-time Processor BC 

IEM4364I Compile-time Processor BC 

IEM4367I Compile-time Processor BC 

IEM4370I Compile-time Processor BC 

IEM4373I Compile-time Processor BC 

IEM4376I Compile-time Processor BC 

IEM4379I Compile-time Processor BC 

IEM4382I Compile-time Processor BC 

IEM4283I Compile-time Processor BC 

IEM4391I Compile-time Processor BC 

IEM4394I Compile-time Processor BC 

IEM4397I Compile-time Processor BC 

IEM4400I Compile-time Processor BC 

IEM4403I Compile-time Processor BC 

IEM4406I Compile-time Processor BC 

IEM4407I Compile-time Processor BC 

IEM4409I Compile-time Processor BC 

IEM4412I Compile-time Processor BC 

IEM4415I Compile-time Processor BC 

IEM4421I Compile-time Processor BC 

IEM4433I Compile-time Processor BG 

IEM4436I Compile-time Processor BG 

IEM4439I Compile-time Processor BG 

IEM4448I Compile-time Processor BG 

IEM4451I Compile-rtime Processor BG 

IEM4452I Compile-time Processor BG 

IEM4454I Compile-time Processor BG 

IEM4457I Compile-time Processor BG 

IEM4460I Compile-time Processor BG 

IEM4463I Compile-time Processor BG 

IEM4469I Compile-time Processor BG 

IEM4472I Compile-time Processor BG 

IEM4473I Compile-time Processor BG 

IEM4475I Compile-time Processor BG 

IEM4478I Compile-time Processor BG 

1EM4481I Compile-time Processor BG 

IEM4484I Compile-time Processor BG 

IEM4499I Compile-time Processor BG 

IEM4502I Compile-time Processor BG 

IEM4504I Compile-time Processor BG 

IEM4505I Compile-time Processor BG 

IEM4506I Compile-time Processor BG 

IEM4508I Compile-time Processor BG 

IEM4511I Compile-time Processor BC 

IEM4514I Compile-time Processor BG 

IEM4517I Compile-time Processor BG 

IEM4520I Compile-time Processor BG 

IEM4523I Compile-time Processor BG 

IEM4526I Compile-time Processor AS 

IEM4529I Compile-time Processor BC,BG 

IEM4532I Compile-time Processor AS 
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I IEM4535I 
IEM4547I 
IEM4550I 
IEM4553I 
IEM4559I 
IEM4562I 


Compile-time Processor AS 
Compile-time Processor AV 
Compile-time Processor BG 
Compile-time Processor BG 
Compile-time Processor BG 
Compile-time Processor BG 


IEM4570I Compile-time Processor BG 
IEM4572I Compile-time Processor BG 
IEM4574I Compile-time Processor BG 
IEM4576I Compile-time Processor BG 
IEM4578I Compile-time Processor BG 
IEM4580I Compile-time Processor BG 
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APPENDIX J: COMPILE-TIME PROCESSOR 


This appendix describes, for the 
Compile-time Processor Logical Phase, the 
internal formats of text and tables, 
communication region use. Operating System 
interfaces and compiler control interfaces. 


was declared. Each procedure is 
assigned a unique number. The 
identifiers in the non-procedural 
text are given the procedure number 
1. The built-in function SUBSTR is 
given the procedure number 0. 


1. INTERNAL FORMATS OF TEXT 


The internal format of text used by the 
compile- time processor is EBCDIC. As 
source input is read into storage, 
non-macro text is moved directly into text 
blocks after translation to internal 
format. Encoded compile-time statements 
and line numbers are also placed in text 
blocks. 


Format of a Dictionary Entry 


The compile-time processor uses a set of 
chained dictionary entries. Hashing 
techniques are used to add an item to the 
dictionary or to search for an entry. A 
compile-time processor dictionary item is a 
variable- length item with the following 
skeletal format: 

The fields defined in this skeleton have 
the following meaning and usage: 

LENGTH: The length of the EBCDIC name. If 
the item has no name (e.g., a 
constant) this field is zero. 

PROC NO.: The number assigned to the 

procedure in which the identifier 


HASH-CHAIN-POINTER: The dictionary address 
of the next item on this hash 
chain. This address is zero if no 
item follows. 

TYPE: A byte which gives the attributes of 
the entry. The bits (if on) have 
been assigned the following 
meanings: 

BIT MEANING 

0 fixed 

1 character 

2 bit 

? entry 

4 label 

5 INCLUDE identifier 

6 iterative DO 

7 constant 

VALUE/VALUE- POINTER: If the item is fixed, 
this contains the value proper 
stored as a five-digit packed 
decimal number. Otherwise it 
contains a pointer to the value 
stored in IVBs. The definition of 
value for the various kinds of 
entries is given below. For a 
fixed macro variable, this contains 
the value. For a character 
variable, it contains a pointer to 
IVBs containing the value. For a 
procedure, it points to the 
text-block location of the code. 


Byte 1 Byte 2 Byte 3 Byte 4 

r t r 1 

Word 1 I LENGTH j PROC NO. j HASH-CHAIN- POINTER j 
* + X ^ 

Word 2 | TYPE | VALUE/VALUE-POINTER | 

Word 3 | FLAGS ] COUNT j 

j. ? J- 1 

Word 4 | POINTERS/PARM-TYPES | 

Word 5 | EBCDIC NAME > | 

L J 

I I 

K 1 

j > EBCDIC NAME | 


Word n 



For a label, it points to the 
text-block location of the label. 

If references to the label are 
found before the label is 
discovered, the value pointer 
temporarily points to a chain of 
IVBs with a description of every 
GOTO transferring to this label. 
This information is processed and 
discarded when the label is found. 
For an INCLUDE identifier, it 
points to the beginning of the 
included text. 

FLAGS: This set of bits provides additional 
information about the use of the 
item. They are used as follows: 

BIT MEANING 

0 special entry bit 

1 DECLARE encountered (Phase 
BC) 

2 procedure body encountered 
(Phase BC) 

3 parameter 

4 used to indicate a procedure 
called by Phase II scan. 

5 DECLARE encountered (Phase 
BG) 

6 unused 

7 ACTIVATE bit 

8 ■in-use" bit 

9 "indirect reference" bit 

10 "undefined" bit for multiple 
declarations 

11 left-hand side (LHS bit) 

This field occupies a half-word. 

COUNT: For a procedure entry, this field 
contains a count of the number of 
parameters for the procedure. For 
INCLUDE identifier it is zero 
initially, and subsequently 
contains the initial line number 
assigned to the included text. 

POINTERS/ PARAM-TYPES : For a procedure, the 
field contains an encoding of the 
type information for each formal 
parameter. Two bits are reserved 
for each parameter. One indicates 
fixed; the other indicates 
character. If neither bit is set, 
this indicates that the entry 
declaration did not specify 
attributes for the parameters. 

For a label, word 4 contains two 
pointers to dictionary items. One 
points to the dictionary entry for 
the immediately embracing iterative 
DO. The second half-word contains 
a pointer to the dictionary entry 
for the immediately embracing 
INCLUDE. This provides a method of 
checking the legality of GOTOs. 


For an INCLUDE identifier, only the 
pointer to the immediately 
embracing INCLUDE is kept. 

During Phase I, word 4 is used for 
labels and simple variables to hold 
two pointers. These form a 
bi-directional chain of all labels 
and variables having the same 
procedure number which have been 
used but not defined. This 
information is used only in Phase I 
and can therefore be overlaid. 

EBCDIC NAME: A variable length field, 

containing the EBCDIC name of the 
item. If the item has no name, 
this field is not included. 


Format of an Identifier Value Block (IVB) 


To hold character and bit string values, 
some text blocks are organised into 
sub-blocks of 32 bytes each. Of these 32 
bytes, 27 are used to hold values or parts 
of values. The first byte is used to hold 
a copy of the last character in the 
preceding IVB. This copy is made to 
facilitate backup. The last four bytes 
consist of a condition code of one byte 
followed by a 3-byte chain pointer. A set 
of these sub-blocks, chained together, is 
used to hold a value. The condition byte 
is 27 for all except the last sub-block in 
a value, in this last condition code byte 
the first bit is set to 1 to indicate 
" end-of -value. " The remaining bits are a 
count of the significant bytes in the 
sub-block. There is a maximum of 27 
significant bytes in an IVB. 

The chain address is used to point to 
the next sub- block in a value. The meaning 
of the chain address in the last sub-block 
in a chain depends on how the chain is 
being used. 

These small chained sub-blocks are 
referred to as "identifier value blocks," 
or IVBs. 

Text blocks are allocated to hold IVBs 
as the need arises. Those IVBs not 
currently in use are chained together into 
an availability chain and are re-used when 
needed. 

An example of a character string value 
held in IVBs is shown. The character 
string, which starts with AB and ends with 
CD, is 28 characters long. Two IVBs are 
thus required to hold the value. The 
string AB...C is put into the first IVB, 
while the last character, D, is put into 
another IVB. The condition code byte of 
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r r T“1 r T T 1 

j ?AB ... C I 0 j > j CD///// I 10000001 j ? j 

l X X — I L X X J 

< 28 > 1 3 < 28 > < 1 > <-3-> 


the first IVB is 27. The second condition 
code byte is 10000001. The first "1" 
indicates end-of-value, while 0000001 is a 
count of the significant characters in the 
IVB. 


Besides holding character-string values, 
IVBs are used in many places by the 
coropile-tirae processor to hold information 
which must be chained from a dictionary 
entry and which is of indefinite length. 
These uses are noted elsewhere. 


Instruction Codes for the Compile-time 
processor 


Compile-time statements are handled in two 
parts. During Phase BC, each statement is 
recognized and syntax checked. An encoded 
form of the statement is then placed into 
the current text block. During Phase BG 
these encoded statements are executed by an 
interpreter. 

All expressions are encoded in postfix 
Polish. A stack is used during Phase II to 
hold all operands. Conversions are done in 
Phase BG. 

Thus the expression (A+B)||c, for 
example, is turned into 

A B * C| | 

To be more explicit, it is turned into the 
instructions 

PUSH A; 

PUSH B 

ADD; 

PUSH C; 

CONCAT 

The PUSH operator pushes its operand 
onto the phase II stack. This stack 
consists of 150 full words in scratch 
storage. The first byte of each call is a 
status byte; the last three bytes hold the 
value if the item is FIXED, a pointer if 
the item is CHARACTER or BIT, or an 
indirect reference to a dictionary entry if 
the indirect bit is on. 


The bits of the status byte have the 
following meaning if set to one; 

BIT MEANING 

0 FIXED 

1 CHARACTER 

2 BIT 

3 Indirect reference (i.e., points 

to a dictionary entry) 

4 Character string value does not 

"belong" to the stack and should 
not be erased when stack is 
popped. (Shared with Phase BG 
scan. ) 

Bits 6-8 are unused by the interpreter. 

They are reserved for Phase BG scan. 

All instructions generated by the Phase 
BC code generators begin with an operation 
byte. Depending on the operation, it may 
be followed by zero or more bytes of 
information which are intrinsically part of 
the instruction. Each instruction may have 
either or both of the characteristics STACK 
and FIXED. The definition of these 
characteristics follows; 

1. STACK. These instructions consist 
only of the one-byte operator. They 
take their operands, if any, from the 
Phase II stack. These operators 
correspond in general to the PL/I 
arithmetic and string operators. 
Depending on whether they are unary or 
binary, they use the top one or two 
items on the stack. Before these 
operands are used, they are converted, 
if necessary, in place to the required 
type. After the items are used they 
are popped from the stack. The result 
of the operation is pushed onto the 
stack. 

The conversion, the popping, and the 
pushing are all implied for a stack 
operator. 

2. FIXED LENGTH. These operations are 
followed by a fixed number of bytes — 
usually two. These bytes, which 
usually refer to a dictionary entry, 
serve as the operand (s) of the 
instruction. 

The table below shows the operations 
that are to encode macro instructions. The 
operand description indicates only the 
general operand type for a variable- length 
item. The count byte is omitted. 
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OPERAND DESCRIPTION 


FUNCTION 


I 

-1 


| MNEMONIC | TYPE | 


* + + f 


| ADD 

| STACK 
j 

| BINARY; OPERANDS, RESULT FIXED 

1 

j A+B 

{ SUB 

| STACK 

i 

i 

j BINARY ; OPERANDS, RESULT FIXED 

1 

1 

j A-B 

| MUX 

1 

j STACK 
j 

1 

| BINARY; OPERANDS, RESULT FIXED 

1 

1 

( A*B 

| DIV 

| STACK 

i 

1 

| BINARY; OPERANDS, RESULT FIXED 

i 

1 

j A/B 

| UNMIN 

I 

j STACK 

i 

1 

| UNARY; OPERAND, RESULT FIXED 

■ 

1 

| — B 

| UNPLS 

| STACK 

l 

1 

j UNARY; OPERAND, RESULT FIXED 
j 

1 

|+B 

| ASSIGN 1 

1 

j STACK 
| FIXED 

l 

(UNARY; B CONVERTED TO TYPE OF A 

1 

i 

1 

| A=B (ass ignment ) 

1 

| NOT 

1 

j STACK 

i 

| UNARY; OPERAND, RESULT BIT 

1 

1 

hB 

| AND 

| STACK 

1 

1 

| BINARY; OPERANDS, RESULT BIT 

i 

j A6B 

| OR 

j STACK 

i 

1 

(BINARY; OPERANDS, RESULT BIT 

1 

(A|B 

| CONCAT 

1 

j STACK 

1 

1 

(BINARY; OPERANDS, RESULT CHAR 
■ 

|A||B 

|EQU a 

1 

j STACK 

l 

|. BINARY; OPERANDS, RESULT VARY 

1 

j A=B (equality) 

| GT a 

1 

j STACK 

l 

1 

| BINARY; OPERANDS, RESULT VARY 

I 

1 

j A>B 

| LT a 

1 

j STACK 
j 

1 

j BINARY; OPERANDS, RESULT VARY 

1 

| A<B 

| INC 

i 

j FIXED 

i 

i 

(Two-byte dictionary reference 

i 

1 

(INCLUDE A 

l 

| ABORT 

1 

j FIXED 
j 

1 

(One- byte code 

1 

| ABORT processing 

|TRA 

| FIXED 
j 

1 

| Two- byte dictionary reference 

1 

(Transfer to label 

(TRAC 

| FIXED 

1 

1 

(Two-byte dictionary reference 

1 

(Transfer to label 

1 

|TRAF 3 

1 

j STACK 
j FIXED 
■ 

1 

(Two- byte dictionary reference 

1 

1 

1 

(Transfer to label 
jif top of stack false. 

| INV S 

| STACK 
j FIXED 
j 

1 

| Two-byte dictionary reference and 
| a one-byte argument count 

i 

1 

| Invokes the procedure 

1 

1 

ITRAI 1 * 

| FIXED 

1 

1 

(two two-byte dictionary references 

1 

1 

(Transfer out of INCLUDE 

1 

| PUSH 

j FIXED 

1 

1 

| Two-byte dictionary reference 

I 

1 

(Push A onto stack 
■ 

| PUSHI 

1 

j FIXED 

1 

i 

1 

(Two- byte dictionary reference 

1 

■ 

1 

| Push address of A 
jonto stack 

(UPDT 

1 

| FIXED 
{ 

1 

| Three- byte line count 

1 

1 

|Put line count into LINCNT 

i 

| ENTM 

| FIXED 
j 

1 

|no operand 

i 

i 

| Enter interpreter 

i 

|RTNS 

| FIXED 

1 

I 

|no operand 

1 

| Return to Phase II scan 

| ENB 

| FIXED 
j 

1 

(Two-byte dictionary references 

■ 

1 

(ACTIVATE A 
■ 

| DSB 

| FIXED 
j 

1 

(Two-byte dictionary references 

i 

1 

(DEACTIVATE A 

l 

| DCL 

| FIXED 
j 

1 

(Dictionary reference 

i 

| DECLARE A 

1 

| NOPD 

1 FIXED 

1 

_J 

1 

(Dictionary reference 

1 

(No-ops the DECLARE, once 
| executed 
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| MNEMONIC | TYPE | OPERAND DESCRIPTION 

* 1 + 

| CVT 6 | FIXED | Dictionary reference 


FUNCTION 


j Convert to RETURNS 
| attribute 


| RETN" 7 | FIXED (Dictionary reference (Return from procedure A | 

j^The ASSIGN operator does not push a result. The expression result is found on ( 
j the PDS and is popped; the dictionary reference for the left hand side is the | 
j single argument. | 

| a Operand conversion for EQU, GT, and LT is as specified in IBM System/360 j 

j Operating System: PL/I Language Specifications . j 

j 3 The TRAF uses and pops the top operand on the stack. It is treated as a bit j 

j string for conditional transfers. | 

j^This handles GOTOs out of included text. At this point CLNUP is performed. The j 
j arguments are (a) the dictionary entry for the label to which control is to pass;| 
j and (b) the dictionary entry for the current INCLUDE. j 

j “The arguments for the invocation are contained on the stack. The dictionary j 

j reference is to the procedure entry. I 

| “This converts the top of the stack to the attributes specified in the RETURNS j 
j attribute for the procedure A. j 

j^This terminates the invocation of procedure A and converts the value on the top | 
j of the stack to the attribute specified on the PROCEDURE statement. j 
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2. COMMUNICATIONS REGION USE 


the compile-time processor. The region 
from ZCOMM to ZCOMM+463 is also used by the 
compiler; however, during the compile-time 
The region from offset 0 to offset 304 processor phase, this region is used 

(ZCOMM) is used as a general communications exclusively by the compile-time processing, 

region throughout the compiler, including The details of this usage are shown below. 
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Name 

STATUS 


Dec. 

Offset 


ZCOMM 


ZCOMM+1 


Contents 


Byte Is Bit 0 not used 

1 PROCSW — processing macro procedure 
Note: 2 FINDBIT -- SRHDIC has found dictionary item 

Condition 3 ERSW — diagnostic produced in Phase II 

Settings 4 EFSW -- end of file encountered (input) 

"1" = set 5 LEVBIT — processing IVB 

"0" = off 6 INCSW — processing included text 

7 PH2SW — in Phase II 

Byte 2: Bit 0 OLDINC — processing already listed INCLUDE 

1 SKPSW — indicates entry to END from PRCSCN 

2 NOPERCENTS W — look ahead for % completed 

3 SYSOPN — SYSLIB DCB is open 

4 MACRO — indicates current macro action 

5 PR2SW — indicates in macro procedure 

7 ARG — indicates that Phase I I is looking for 
arguments of activated procedure 


SUBSTRDR 

|ZCOMM+2 j 

) j 

2 

1 

1 

Holds dictionary reference of 0 level SUBSTR entry 

TOKPTR 

| ZCOMM+ 4 | 

1 1 
j 

4 

1 

1 

1 

1 

Address of character being scanned, text reference or 
absolute, right justified 

INCPTR 

| ZCOMM+ 8 | 

i 1 

4 

1 

1 

1 

Save area for TOKPTR 

INBUF 

1 ! 

j ZCOMM+1 2 j 

j j 

4 

1 

1 

1 

Absolute address of input buffer, right justified 

OUTBUF 

| ZCOMM+1 6 j 

4 

1 

1 

I 

Absolute address of output buffer, right justified 

PDSPTR 

| ZCOMM+20 | 

j j 

4 

I 

1 

I 

Absolute address to top of pushdown stack, right justified 

ENDSUF 

j ZCOMM+24 ■ | 

1 1 

j j 

4 

1 

1 

1 

i 

Absolute address to last significant character in input 
buffer, right justified 

WHERE 

| ZCOMM+ 28 | 

1 1 
| 

4 

1 

1 

1 

t 

Address of next available byte in output buffer, text 
reference or absolute, right justified 

IVBPTR 

| ZCOMM+ 3 2 J 
j 

4 

1 

1 

I 

Text reference to next free IVB, right justified 

LINCNT 

| ZCOMM+36 j 
j 

4 

1 

1 

1 

Holds current line number, right justified 

TEMPTR 

| ZCOMM+40 | 

j j 

2 

1 

1 

1 

Dictionary reference to top of "in-use" temporary stack 

DCENTY 

| ZCOMM+42 | 

j j 

2 

1 

1 

i 

Dictionary reference for chaining dictionary items 

CURINC 

| ZCOMM+ 4 4 | 

j j 

2 

1 

1 

1 

Dictionary reference to INCLUDE entry being processed 

CURDO 

| ZCOMM+ 4 6 | 

1 

2 

1 

1 

1 

Dictionary reference to DO entry being processed 

PROCNO 

| ZCOMM+48 | 
j 

1 

1 

1 

1 

Current procedure number, right justified 

NXTPC 

| ZCOMM+49 | 

j 

1 

1 

1 

I 

Next available procedure number, right justified 

DPHCNT 

| ZCOMM+50 | 

i 1 

2 

1 

1 

1 

Current depth count 

CODE 

1 1 

| ZCOMM+ 5 2 j 

I | 

1 

1 

1 

■ 

Code for token type 

LENGTH 

| ZCOMM+54 | 

i ; 

2 

1 

1 

1 

Number of signifiant characters in TOKBUF , right justified 

MXDPTH 

i i 

| ZCOMM+56 j 
j j 

2 

1 

1 

1 

Integer value of depth of replacement, right justified 

INDEX 

| ZCOMM+58 | 

-L i_ 

2 

1 

1 

L. 

Hash table index for dictionary routines 
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r 

1 Name 

L 

T 

| Dec. 

1 Offset 

X _ 

r 

' T 

j ATTR 

j ZCOMM+6 0 

| GRSAVE 

1 

j ZCOMM+64 

i 

| NEWIVB 

1 

j ZCOMM+68 

i 

| VALUE 

1 

|ZCOMM+72 

i 

| PREINB 

i 

IZCOMM+76 

| BUFSRT 

1 

IZCOMM+80 

i 

| INIVB 

1 

JZCOMM+84 

1 

| OUTIVB 

1 

| ZCOMM+85 

| TXTBLK 

l 

| ZCOMM+86 

| INVBAB 

i 

1 

| ZCOMM+88 

i i 

j OUTIVBAB j ZCOMM+ 92 

l l 

1 1 

j TXTBLKAB | ZCOMM+96 

■ i 

1 

| MTABC 

i 

1 

j ZCOMM+lOO 

i 

I 

j TXTEST 

i 

1 

jZCOMM+104 

i 

1 

j BUF1 

1 

j ZCOMM+108 
| 

1 

{ BUF2 

I 

1 

| ZCOMM+112 
■ 

1 

j LIBDCB 

1 

jZCOMM+116 

1 

j USRDCB 
• 

1 

|ZCOMM+120 

I 

1 

|MAXLCT 

■ 

i 

jZCOMM+124 

1 

| PRCWHR 

i 

1 

j ZCOMM+128 

i 

i i 

j DCENTYAB j ZCOMM+ 132 

i i 

1 

j SCHK 
■ 

1 

IZCOMM-H36 

i 

1 

j PROCCL 

l 

1 

j ZCOMM+140 

I 

1 

j OUTERCL 

i 

1 

j ZCOMM+142 

i 

| PROCCLDR j ZCOMM+144 

1 1 

j OUTRCLDR j ZCOMM+146 

■ i 

1 

j DECIDR 

■ 

1 

jZCOMM+148 

• 

1 

jCURPRC 

■ 

1 

j ZCOMM+152 

i 

1 

j TOKBUF 

1 

IZCOMM+164 


Length 

2 


Contents 

"Type" byte for dictionary routines 
Save area for GRG 

Pointer to IVB chain to be freed or obtained 

Type and value/value pointer for dictionary entries 

Pointer to header information for INBUF 

Pointer to left margin in INBUF 

Current busy block number 

Current busy block number 

Current busy block number 

Current block used in absolute address calculation 

Current block used in absolute address calculation 

Current block used in absolute address calculation 

Address of translate table for TOKSCN and FINDPC 

Length of text block adjusted for chain address 

Pointer to first INCLUDE buffer 

Pointer to second INCLUDE buffer 

Pointer to DCB for SYSLIB data set 

Pointer to DCB for user data sets 

Maximum line count used so far 

Pointer to next byte in which to put procedure text 

Absolute address of dictionary entry 

Pointer to level 1 SUBSTR entry 

Dictionary reference of procedure check list 

Dictionary reference of outer check list 

Dictionary reference for PROCCL cell 

Dictionary reference for OUTERCL cell 

Dictionary reference of dictionary entry for DECIMAL 1 

Pointer to current procedure entry on PDS 

32-byte buffer, characters inserted left justified 
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r 

1 

1 Name 

j. 

T - - 

| Dec. 

1 Offset 
-j. 

| HA STB 

1 

| ZCOMM+ 300 

1 

1 

j CONSCH 

I 

| ZCOMM+428 

i 

1 

j SPECCH 

| ZCOMM+ 430 


T 


I Length 

| 

I 128 


2 


I 2 


+ 


- 1 

Contents j 

^ 

64 two-byte dictionary references to hash chains for named | 

items j 

Dictionary reference to constant chain | 

Dictionary reference to special chain — debugging only | 


3. COMPILE-TIME PROCESSOR, OPERATING 
SYSTEM. AND COMPILER CONTROL INTERFACES 


Although the compile-time processor makes 
considerable use of the Operating System 
facilities, it usually does so indirectly 
through the compiler control. However, 
those Operating System services required to 
support the INCLUDE facility are invoked 
directly. Since included text is required 
to be a member of a partitioned data set, 
it is those data management facilities 
which support BPAM which are used. 
Specifically the macros OPEN, FIND, CLOSE, 
READ and CHECK are used by various parts of 
the INCLUDE handler. Details of these 
macros can be found in IBM System/360 
Operating System, Supervisor and Data 
Management Services . 


The root phase is invoked by the 
compiler control if the MACRO option is 
specified. All subsequent communication 
between the compile-time phases and the 
compiler control is done by way of cells in 
the communications region. This includes 
the parameters passed to the F service 
routines, the decoded options which are 
tested, and the cells set to indicate the 
status of source margins and mode (EBCDIC) 
of the output. 

Specifically, the following cells in the 
communications region are either used or 
set; 

PARI 

PAR2 


ZTV 

ZMYNAM 

MCSIZE 

CCCODE 

TXTSZ 

ZSOR — column number in which to begin 
scan of input text 

ZMAG — column number in which to end 
scan of input text 

ZTRAN1 

The following compiler control routines 
are referenced; 


ZUPL 

RELESE 

ZURD 

RLSCTL 

ZUGC 

ZTXTRF 

ZUTXTC 

ZTXTAB 

ZURC 

ZCHAIN 

ZABORT 

ZALTER 

ZLOADW 

ZDABRF 

ZDICRF 

ZEND 

ZUERR 

ZUBW 

ZDRFAB 
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APPENDIX K; TABLE HANDLING ROUTINES FOR K PHASES 


The purpose of these routines is to permit 
the user to build, scan and otherwise 
manipulate tables in text blocks without 
any concern for physical block boundaries, 
status of text blocks or maintaining 
pointers to first, last and current table 
entries. The routines also handle text, 
which is assumed to be a special type of 
table. 

The user mays 

1. Define a table by using the IEMKTCA 
macro to set up a TCA (task 
communication area) control block. 

The address of the TCA is always 
passed to a table handling routine and 
identifies the table concerned. Most 
TCAs will be held in the local 
communications region in phase KA. 

2. Add new entries to the end of a table. 
Table entries may be of fixed or 
varying lengths. For fixed length 
entries, the length is held in the TCA 
for the table. For varying length 
entries, the TCA contains information 
enabling the routine to determine the 
length of the entry. Fixed length 
entries may be built in storage and 
moved into the table by the routines, 
or space allocated for an entry by the 
routines and the entry built directly 
into the table. For varying length 
entries, the entry must be built in 
storage and moved into the table by 
the routines. 

3. Scan a table either forwards or 
backwards. The user requests the 
address and text reference of the 
•next' table entry. The user may 
position a scan to the start or end of 
a table, or to some intermediate 
point. 

4. Reference individual table entries at 
random. This may be done while a 
sequential scan of the table is being 
performed, and will not affect the 
scan. 

5. Specify that a table is to be deleted. 

6. Specify that entries are to be 'locked 
in*. This means that the absolute 
address of a table entry will remain 
valid until the entry is explicitly or 
implicitly unlocked, or the table is 
deactivated. (see 7). If an entry is 
not 'locked in', any subsequent call 
to the table handling routines may 


render the absolute address returned 
for the entry invalid. The current 
entry of a sequential scan, either 
creating or reading, is automatically 
'locked in' . 

A randomly referenced entry is only 
locked by an explicit lock request. 

A current scan entry may be unlocked 
explicitly by deactivating the table, 
or implicitly by making or requesting 
the next entry, or repositioning the 
scan. 

A random entry may be explicitly 
unlocked, or implicitly unlocked by 
another random reference to the same 
table specifying lock. 

All locks are released when a table is 
deactivated. The total number of 
locked entries for all tables must not 
exceed four at any one time. 

7. Activate or deactivate a table. All 
tables are initially deactivated. 
Tables are always activated 
implicitly, initially by a request to 
add an entry to the table, and 
subsequently by any valid request for 
an operation to be performed on that 
table. 

A table may be deactivated by an 
explicit request. Deactivation causes 
all locked entries to be unlocked, and 
renders all absolute addresses of 
entries in that table invalid. 
Sequential scans are not otherwise 
affected. 

A table is implicitly deactivated by a 
request to free the table (as in 5), 
or if the table contains no locked 
entries and any call is made to the 
table handling routines. 


DESCRIPTION AND FORMAT OF 
MACRO- INSTRUCTIONS 


The IEMKTCA Macro 


This macro is used to set up a TCA (table 
control area) control block describing a 
table to be processed by the table handling 
routines. The macro has two functions: 
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1. Sets up global variables describing 
tables which are used by the IEMKTAB 
macro to generate appropriate linkages 
to the table handling routines. 

2. Used with the R operand to set up a 
TCA control block the address of which 
is passed to the table handling 
routines to identify the table. The 
'table identifier' is the same as the 
'table2 identifier' used in IEMKTAB 
macro instructions. It must also be 
the label of a fullword containing, at 
execution time, the address of the TCA 


set up by a IEMKTC& macro instruction 
with the R operand. 


Format: 


(F) 


table identifier IEMKTCA t,R,]ET=(V) 

(T) 

[,L=entry length] t ,OPS= t S 3 CR] ] 


[,NPTRS=no of scan pointers.] 
t, DLF=displacement to length field] 


Description of Parameters 


| Parameter | 


h 


Description 


This parameter indicates the type of entry contained in the table, as 
follows I 


•H 


ET=entry type 


T - text 


follows : 

F - fixed length entries 
V - variable length entries 


L=entry length 




This parameter is required if ET=F is coded, and indicates the length 
of an entry. 


OPS=operations 


This parameter indicates the type of operations to be performed on the 
table, as follows: 


s - sequential scans will be performed 
R - random references will be made 


NPTRS=n 




This parameter permits more than one sequential scan of one table to be 
made at one time. 'n* indicates the maximum number of sequential scans 
which will be in progress at any one time. An individual scan is 
identified by coding PTR=n in the SET, SETZ or SCAN operation (see 
IEMKTAB) macro). The default value is n=l if OPS=S or RS is coded, or 
OPS is omitted, otherwise n=0. If ET-T is coded, this parameter must 
be omitted and only one scan is permitted. 


DLF=disp. 
to length 
field 

R 


This indicates the displacement from the first byte of the entry to 
the two byte field containing the length of the entry. It must must be 
coded if ET=V is coded. 

This parameter is supplied only if actual code is to be generated from 
the macro instruction. It provides a label for the TCA which may be 
used in an A type address constant having the label identifier as its 
label. 
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Example of use: 


The I EMKTAB Macro 


TABLE 1 DC A(ATABl) 

TABLE1 DTCA ATAB1 , ET=F, L= 8 , OpS=S 

Note: the label on the IFMKTCA 

macro-instruction statement is not 
made the label of any generated 
statement, so no multiple definition 
will result. Its only use is to 
provide a link between the two macros 
IEMKTCA and IEMKTAB. 


This macro specifies operations to be 
performed on a table or tables. The table 
to be operated on is always specified by 
supplying the address of its TCA . 


Format : 

[label] IEMKTAB code, parameters 

Note: 'code* specifies the type of 

operation, and the parameters depend 
on this as shown below: 


r t- 

| Code | 

F +- 

I ELDC I 


Parameters 


Table Identifier, address of entry skeleton 
[ , AATO=] [,SATO=] 


* +- 

|BLDT | 

Y +- 


Tacle Identifier [,AATO=] [,SATO=] 




(N) 

DR j Table Identifier, SA=[,AATO=3 [,0PT=(L)3 


h 




■H 


-H 


| ULDR | 

I- +' 

j SET | 

I— 


(Table Identifier,...) or Table Identifier 
Table Identifier, SA=[,PTR=n] 




I 

| SETZ | 

h f 


(F) 

Table Identifier [,0PT=(B)3 [,PTR=n3 


(F) 

j SCAN j Table Identifier [,AAT0=3 t,SAT0=3 [,OPT=(B)3 
1 | [,PTR=n] [,ETA=3 [ , TRTAB= , FBTO= 3 [,PSAT0=3 


k +- 

| FREE | 

Y +- 


(Table Identifier,...) or Table Identifier 
(Table Identifier,...) or Table Identifier 
Table Identifier, NTA= 


| DEACT | 

f +- 

j TEST j 
L X. 






Notes ; 


The 'Table Identifier' operand must 
appear in the label field of a IEMKTCA 
macro-instruction physically preceding the 
IEMKTAE macro- instruction. The last three 
operands of the SCAN operation (TRTAB, 
FBTO, PSATO) only apply to text tables 
ET = T in IEMKTCA) . 
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Keyword 

Parameter 


Description 


A register designation or address of a fullword in which the returned 
absolute address is to be placed. 


Address of a three byte field in which the returned symbolic address is toj 
be placed. j 

Address of a three byte area containing a symbolic address. | 


Options applying to this operation. The option letters may appear in any 
order. 


V 

I ETA 


j Specifies the pointer which identifies the current record of the scan. ' n* 
j must not exceed the number specified in the NPTRS parameter of the IEMKTCA| 
j macro- instruct ion. C indicates the end of table pointer for creating new j 
j entries. j 

j Specifies the address of a routine to be given control when the end of a | 
j table is detected during a sequential scan. j 


TRTAB 


I- 

I PSATO 


j Address of translate table for selective scan. 

j Location or register in which non-zero function byte from translate 
j operation is to be placed. 

j Address of a three byte area into which the symbolic address of the 
j previous entry is to be placed. 


j Address of routine to receive control if table is null. 


Note: A register designation (absolute expression in parentheses) identifying general 

registers 2-9 may be used in the AATO, SATO, SA, ETA, FBTO, PSATO and NTA operands. 
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Description of Table Handling Operations 


I T - 

| Operation | 


Description 


Adds an entry to the end of a table. The entry is built in storage by the 
user and moved to the table by the table handling routines. The routines 
return the symbolic and absolute addresses of the new entry. 


The table handling routines allocate space for a new entry at the end of 
the specified table, and return the absolute and symbolic addresses of the 
space. The user builds his entry in the space allocated. This operation 
can only be specified if ET=F was coded in the IEMKTCA macro-instruction. 


j Direct (random) reference. The entry is identified by the SA parameter. 

| The absolute address of the entry is returned. If OPT=L is specified, the 
j entry is locked in. 

j The last directly referenced entry for this table that specified OPT=L, is 
unlocked. 


The sequential scan is positioned at the entry identified by the SA 
parameter. The next SCAN operation causes the absolute address of this 
entry to be returned. PTR=n (see SETZ) . 


I 

I SCAN 


j The sequential scan is positioned to tbe beginning of the table if the OPT| 
j parameter is omitted or OPT=F is coded, or to the end of the table if j 
j OPT=B is coded. The next SCAN operation returns the absolute address of | 
| the first or last table entry to be returned. The PTR=n parameter | 
j indicates which sequential scan is meant if more than one is in progress j 
j at one time. 'n* may not exceed the number specified in' the NPTRS j 
j parameter of the IEMKTCA macro- in struct ion. PTR=1 is assumed if the j 
| parameter is omitted. OPT=B may not be coded if ET=V or T is coded in thej 
j IEMKTCA macro- instruction for the table. | 

j The symbolic and absolute addresses of the next entry in the table are j 
j returned. If a SET or SETZ was the last operation, the next entry is thatj 
j pointed to by the SET or SETZ operations. The options F or B indicate: j 
j F a forward scan is required. This is the default. j 
j B a backward scan is required. This may only be specified if ET=F is | 
I coded in the IEMKTCA macro-instruction. 


Selective Scanning Facility 


This facility is available for text tables 
only (ET=T in IEMKTCA macro-instruction). 
The TRTAB operand identifies a 256 byte 
translate table which is used to translate 
the code byte of the entry. If the result 
is zero, the scan continues until the 
routine exits to the ETA address. If the 
result is non-zero, it is placed in the 
register or location identified by the FBTO 
operand, and control returns to the user, 
the AATO and SATO operands identifying the 
selected entry. 


j Code j 

h +~ 


Description 


j. — 

I DEACT 


h + 

I TEST I 


t ±. 


| One or more tables are completely 
j freed and deactivated. The next 
| operation on the table must be a 
j BLDC or BLDT. 

j The table or tables are 
j deactivated. All locked entries 
| are unblocked and all absolute 
| addresses of entries rendered 
| invalid. 

+ i 

| Tests for a null table. If table 
| is null, control is passed to 
| routine identified by NTA 
| pointer. 
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APPENDIX Ls CONTROL ROUTINES 


Entry to the various compiler control 
routines is via a transfer vector. Details 
of the transfer vector appear below. 


r t 

| Hex. | 
Offset 


Name 

ZUPL 

ZURD 

ZUGC 

ZUTXTC 

ZURC 

ZABORT 

ZLOADW 

ZDICAB 

ZDICRF 

ZUERR 

ZDRFAB 

ZLOADX 

REQUEST 

RELESE 

RLSCTL 

ZDUMP 




Description j 

Print a line 

Read a card 

Get Scratch storage 

Get text block 

Release scratch storage 

Dump and go to error 
message routines 

Load and return to 
caller 

Make dictionary entry. 
Absolute address 
returned 

Make dictionary entry. 
Dictionary reference 
returned 

Make error message entry 

Convert dictionary 
reference to absolute 
address 

Load with overlay and 
return to caller 

Give a list of phase 
names required or not 
wanted for this 
compilation 

Release all named phases 

Release all named phases 
and pass to next phase 

Dump specified main 
storage and continue 


r 

1 

1- 

1 

Hex. 

Offset 

y T 1 

II I 

I Name | Description 1 

X J. i 

50 

j ZTXTRF 

r 1 

Converts absolute | 

1 


1 

address to text | 

1 

I 


1 

1 

reference | 

1 

1 

54 

I 

| ZTXTAB 

Convert text reference | 

1 

i 


1 

to absolute address | 

I 

1 

i 

58 

I 

j Z CHAIN 

1 

Find next block in chain | 

1 

1 

1 

5C 

1 

j ZALTER 

1 

Change text block status | 

1 

1 

60 

1 

j ZDABRF 

Convert absolute address j 

1 

1 


1 

| 

to dictionary reference j 

l 

1 

64 

| ZNALRF 

Make unaligned | 

1 


1 

dictionary entry. j 

1 

1 


1 

1 

Reference returned j 

1 

1 

68 

1 

j ZNALDB 

Make unaligned | 

1 


1 

dictionary entry. | 

1 



Absolute address | 

1 


1 

I 

returned j 

1 

1 

i 

6C 

1 

| ZEND 

Terminate job j 

1 

1 

1 

70 

1 

j ZULF 

i 

Write on load file | 

1 

1 

i 

74 

1 

| ZUSP 

1 

Write on punch | 

1 

1 

78 

| ZUBW 

Write on auxiliary | 

1 

1 


1 

storage j 

1 

1 

80 

1 

| RLSCTLX 

Release all named phases | 

1 


1 

and hand control to the | 

1 


1 

next phase, after having | 

1 

i 


1 

1 

loaded it with overlay j 

1 

1 

84 

1 

| RECONS 

Reconstitute j 

1 


1 

1 

instructions in IEMAL j 

1 

1 

88 

1 

| DYNAMIC 

Pass control to the j 

1 


1 

dynamic dump routines, j 

1 

1 


1 

i 

if required | 

1 

1 

8C 

1 IEMAL/ 

Address of second | 

1 

L 


| IEMAN j control phase j 
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COMPILER CONTROL ROUTINES 


r 

| Name 

I 

K 

RELESE 


h 

| REQEST 


H 


Deletes list of phases 
Parameters Passed 


PARI byte 0 unused 

1-3 address of list of phases to be deleted. The list of 
phase names, each of two characters, is 
terminated by the name ZZ 

Parameters Returned 


Hex . 

Offset | 

Description 



Details 


None 

40 I Description 

Marks phases as 'wanted* or 'not wanted' 


Parameters Passed 
PARI byte 0 unused 

1-3 address of list of phases to be marked as 'wanted* 
PAR2 byte 0 unused 

1-3 address of list of phases to be marked as 
'not wanted* 

Parameters Returned 

None 


Notes 

A phase list containing only *ZZ* is effectively a null list. 

During module AM phases of the compiler are all marked as either 
normally loaded or not loaded. A phase which is normally not loaded 
is only loaded if it has previously been marked as 'wanted*. A 
phase which is normally loaded will always be loaded unless it has 
previously been marked as 'not wanted* 
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Hex. 

Offset 


Details 


RLSCTL 


Y 

I RLSCTLX 


Description 

Deletes a list of loaded phases and passes control to next phase 
Parameters Passed 
PARI byte 0 unused 

1-3 address of list of phases to be deleted before next 
phase is loaded 

PAR2 byte 0 unused 

1-3 (a) zero, if next phase is to be taken from compiler 
control phase directory 
(b) address of phase name to be loaded next 

Parameters Returned (to next phase) 

PARI byte 0 unused 

1-3 address of new phase load point 

Notes 

List of phases given by the address in PARI is deleted. Then the 
next phase is selected and loaded and control is passed to a point 
two bytes from the load point of the new phase 

Description 

Releases all named phases and passes control to next phase. The 
next phase may be loaded more than once 

Parameters Passed 

PARI byte 0 unused 

1-3 address of list of phases to be deleted before next 
phase is loaded 

PAR2 byte 0 unused 

1-3 (a) zero of next phase is to be taken from compiler 
control phase directory 
(b) address of phase to be loaded next 

Parameters Returned (to next phase) 

PARI byte 0 unused 

1-3 address of load point of new phase 

Notes 

1. List of phases given by the address in PARI is deleted. The 
next phase is selected and loaded and control is passed to a point 
two bytes from the load point of the new phase 

2. The entry point RLSCTLX does not cause the compiler control 
routines to advance the pointer in the table of phases still to be 
loaded, and does not cause the phase to be marked as already loaded 
once 
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notes 

1. No check is made that this address is the start of a dictionary 
entry, or that it is any other specific point 

2. No check is made that the address is in the same block as the 
dictionary reference passed. If this is the case, that is, the 
parameters passed are in error, the dictionary reference returned 
may not correspond to the address 
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Hex. 

Offset 


Details 


ZDICAB 


Description 

Makes aligned dictionary entry and returns absolute address 
parameters Passed 
PARI byte 0 unused 

1- 3 address of entry (as built by calling phase) 

PAR2 bytes 0-1 unused 

2- 3 length of entry (binary) 

Parameters Returned 

PARI byte 0 unused 

1- 3 dictionary entry address 

PAR 4 bytes 0-1 unused 

2- 3 reference to some point in the same dictionary block 

Notes 

1. The entry built is constructed complete with code byte and 
length fields. The length passed in PAR2 is the length of the 
complete entry 

2. ZDICRF performs the same function and returns more information, 
with no loss in efficiency 


ZDICRF 


Description 

Makes an aligned dictionary entry and returns its dictionary 
reference and absolute address 

Parameters Passed 

PARI byte 0 unused 

1- 3 address of entry 

PAR2 oytes 0-1 unused 

2- 3 length of entry (binary) 

Parameters Returned 

PARI bytes 0-1 unused 

2-3 dictionary reference of entry 

PAR 4 byte 0 unused 

1-3 dictionary entry address 

Notes 

See ZDICAB 
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| hex . 
Offset 


Details 


ZDRFAB 


ZDUMP 


Description 

Converts dictionary reference to absolute address 

Parameters Passed 

PARI bytes 0-1 unused 

2-3 dictionary reference 

Parameters Returned 

PARI byte 0 unused 

1-3 absolute address 


Description 

Dumps specified storage and continues 

Parameters Passed 

PARI byte 0 X'00' 

1-3 unused 

PAR3 bytes 0-3 either (a) zero 

or (b) address of a page heading to be printed 

Parameters Returned 


Notes 

1. The areas to be dumped, and the editing to be done on them, is 
given in the DUMP parameter to the compilation 

2. The dump is only produced if the two character name in ZMYNAM 
matches one of the phase names specified in the DUMP parameter 

3. The message "PHASE zz COMPLETED" is printed if ' P* is included 
in the DUMP parameter even thougth control is returned to the point 
of invocation in the phase 

4. The registers printed by the dump routine are not necessarily as 
when control was passed from the callina phase 


Description 


Terminates compilation immediately 


Parameters Passed 


Parameters Returned 
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| hex. 
Offset 


ZLOADN 


ZLOADX 



Notes | 

1. Control is returned to calling phase, not to phase loaded | 

2. The phase loaded may be loaded again, since it is not marked as | 

loaded by this entry point (see ZLOADW) j 

j 
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| Hex. 
Offset 


Details 


ZNALAB 


Description 

Makes unaligned dictionary entry and returns absolute address 
Parameters Passed 

PARI byte 0 unused 

1- 3 address of entry 

PAR2 bytes 0-1 unused 

2- 3 length of entry (binary) 

Parameters Returned 

PARI byte 0 unused 

1- 3 dictionary entry address 

PAR 4 bytes 0-1 unused 

2- 3 reference to some point in the same dictionary block 

Motes 

1. The entry is constructed exactly as it will appear in the 
dictionary, complete with code byte and length field 

2. ZNALRF performs the same function and returns more information, 
with no loss in efficiency 


ZNALRF 


Description 

Makes unaligned dictionary entry and returns its dictionary 
reference and absolute address 

Parameters Passed 

PARI byte 0 unused 

1- 3 address of entry 

PAR2 bytes 0-1 unused 

2- 3 length of entry (binary) 

Parameters Returned 

PARI bytes 0-1 unused 

2-3 dictionary reference of entry 

PAR 4 bytes 0 unused 

1-3 dictionary entry address 

Notes 

1. See ZNALAB 
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ZTXTAB 


ZTXTRF 


Hex. 

Offset 


Details 


Description 

Converts text reference to absolute address 
Parameters Passed 

PARI byte 0 X'80' if status of block to remain unchanged 

not X’80* - text block set to busy 
1-3 text reference to be converted 

Parameters Returned 

PARI byte 0 unused 

1-3 absolute address corresponding to text reference 


Description 

Converts absolute address to text reference 
Parameters Passed 
PARI byte 0 unused 

1 block number of text block containing absolute address 
2-3 unused 

PAR 2 byte 0 unused 

1-3 address to be converted 

Parameters Returned 

PARI byte 0 unused 

1-3 text reference corresponding to absolute address 

Notes 

1. This routine is of use in only a few cases since it requires to 
be passed the block number containing the absolute address, and only 
returns the offset from the start of the block. This offset can be 
calculated, if the text block is scanned sequentially, by 
subtracting the address of the start of the block 


Description 

Writes on backing storage 
Parameters Passed 

PARI byte 0 unused 

1- 3 address of output record 

PAR2 bytes 0-1 unused 

2- 3 length of record (binary) 

Parameters Returned 
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Hex. 

Offset 


Details 


ZUERR 


Description 

Inserts diagnostic messages in dictionary 
Parameters Passed 

PAR 5 bytes 0-1 unused 

2-3 numeric parameter, if any (halfword binary) 

PAR6 byte 0 unused 

1-2 message number (hexadecimal) 

3 bit 0 on if text to be inserted 

1 on if statement number to be inserted 

2 on if numeric parameter to be inserted 

3 on if dictionary reference to be inserted 
4-7 severity code of message 

X* 0 ' Termination 
X * 4 ' Severe 
X'8* Error 
X'C' Warning 

PAR7 either: 

byte 0 unused 

1- 3 address of text to be inserted 
or: byte 0-1 unused 

2- 3 dictionary reference to be inserted 

PAR8 bytes 0-1 unused 

2-3 length of text to be inserted 

Parameters Returned 


I 

I 

4 


Notes | 

1. when the message is printed the numeric parameter is converted j 
to decimal and inserted into the message. PAR5 is unused if bit 2 | 
of byte 3 in PAR6 is off | 

2. If bit 1 is on, the statement number is taken from the ZSTAT j 
slot in the communications region at the time ZUERR is called j 

3. Bits 0 and 3 are mutually exclusive and if both are on in a callj 
to ZUERR, the routine aborts j 

4. if bit 3 is on, the dictionary reference from PAR7 is inserted j 
into the message dictionary entry. The error message phases pick upj 
the BCD from the dictionary entry, indicated by the reference, and j 
insert it into the message j 

5. If bit 0 is on, text is picked up from the address given in j 
PAR7. This text is in compiler internal representation. The length j 
of the text is taken from PAR8 . The maximum length of text inserted! 
into a message is 10 characters. If the length given is greater | 
than 10 the text is truncated to 10 characters. If the text has j 
been truncated it is enclosed in quotes in the message | 
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Notes 

1. Jf an uncorrectabie I/O error occurs on this data set the option 
LOAD is switched off, a message is produced, and the compilation 
continues without producing an object module 

2. The last 8 bytes of the record will contain: 

bytes 73-76 name of object module, taken from SPP.NA''. in the 

communications region. This is set from the first 
four characters of the first entry label of the 
external procedure 
77-80 sequence number 
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Hex. 

Offset 


Details 


Description 

Puts record out to SYSPRINT Data Set 
Parameters Passed 
PARI byte 0 unused 

1-3 address of area defining print line 

PAR3 bytes 0-3 zero if no secondary heading to be printed 

or address of area defining secondary heading line 

Parameters Returned 


1. Paging action is performed automatically 

2. Format of area containing print line is: 
byte 0 x * 0 0 1 

1 total length of area (binary) 

2 ASA control character 

3 line to be printed-EBCDIC, variable length, maximum 132 
characters 


Description 


Releases scratch storage got by ZUGC 
Parameters Passed 


PARI bytes 0-3 count of entries to ZUGC to be released (binary) 
Parameters Returned 


The routine frees all the storage that was allocated by the last n 
calls to ZUGC, where n is given by PARI 


D escripti on 

Heads record from SYSIN 
Parameters Passed 
PARI byte 0 unused 

1- 3 address of area into which record is to be placed 
Parameters Returned 

PAR 2 bytes 0-1 unused 

2- 3 length of record returned (binary) 
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f ZUTXTC 


Hex. | 
Offset | 

74 I 


Details 


Description 


Puts record out to SYSPUNCH 
Parameters Passed 
PARI byte 0 unused 

1-3 address of 72 byte area containing record to be 
written 

Parameters Returned 


Notes 

1. The relevant option is PUNCH. See ZULF for other notes 


Description 

Gets new text block and optionally chains it to a current block 
Parameters Passed 
PARI byte 0 unused 

1-3 text reference to a current block if new one is 
to be chained 

PAR2 bytes 0-2 unused 

3 X'OO* no chaining 

or X'8n* chaining where n is status required for 
current block 

Parameters Returned 

PARI byte 0 unused 

1-3 text reference to new block 

PAR2 byte 0 unused 

1-3 absolute address of start of new block 

Notes 

1. The new block is set to a status of 'busy* 

2. See ZALTER for definition of status of blocks 
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INDEX 


Indexes to program logic manuals are consolidated in the publication IBM System/ 360 
Operating system: Program Logic Manual Master Index . Form Y28-6717. For additional 
information about any subject listed below, refer to other publications listed for the 
same subject in the Master Index. 


abbreviations used during 

compilation 439-448 

abnormal termination 23 

absolute addresses, conversion 15 

absolute code, instruction formats 433-434 

accumulator register 64 

additions to text 40 

adjustable bounds 34 

ADV (see array dope vector) 

aggregate length table 65 

aggregates logical phase 46 

aggregates, RDV for CONTROLLED or BASED 57 

aliasing, of variables 47 

alignment, by structure processor 46 

ALLOCATE chain 29 

annotated dictionary dump 25 

annotated text dump 25 

AREA 25 

argument markers 52 
arithmetic registers 51 
array bounds 32 
array dope vector (ADV) 39 
array multipliers, calculated in structure 
processor 46 
arrays 

of string dope vectors 46 
of strings, calculations with VARYING 
attribute 46 
assigned registers 67 
ASSIGNMENT triples 59 
ATR option 39 

attribute collection area 35 
scanned for SETS 37 
attribute list, scanned 34 
attributes 

consistency 29 
consistency analyzed 31 
dictionary entries 28 
incons istent 3 4 
invalid 34 

syntax checking in read- in phase 31 
test for consistency 32 
when printed 40 
AUTOMATIC chain 38 
housekeeping 39 
in structure processor 46 
scan in pseudo-code phase 51 
VDA 63 

auxiliary storage 17 
spilling 15 


base registers 67 

based variable expression (BVEXP) 39 

BASED variables, RDV 57 

batch compilation 26 

BCD, translation 26 

BEGIN statements, count 29 

BLDL 26 


BLDL macro 23 

phase directory construction 386 
block control 21 
block control area 22 
block header chains 33 
block nesting levels 30 
block size 

determination of 15 
dictionary 15 
selection 22 
SIZE option 22 
text 15 
bound slot 39 

boundary alignment, by structure 
processor 46 
build list 23 

phase directory construction 386 
built-in function handler 28 
built-in functions 
EMPTY 42 
generic 33 
non- gen eric 33 
NULL 42 
NULLO 42 
scan for 54 
TRANSLATE 52,277 
VERIFY 53, 277 

BUY ASSIGN statements, scan in pseudo- code 
phase 59 
BUY statement 42 

scan in pseudo-code phase 59 
BUY triples, in pseudo-code phase 55 
BVEXP (see based variable expression) 

BXH instruction, used to generate 
pseudo-code 47 

BXLE instruction, used to generate 
pseudo-code 47 

BY NAME option, in pretranslator phase 40 


CALL chain 29 
calling program 21 
cards, control 26.1,86 
catalogued procedures 15 
CCCODE 26 
chains 26 

ALLOCATE 29 
AUTOMATIC 38-39 
hous ekeeping 3 9 
in structure processor 46 
scan in pseudo-code phase 51 
VDA region 63 
block header 33 
CALL 29 
circular 33 

COBOL, in preprocessor 46 
constants 38,60-61 
constructed by read-in 29 
CONTROLLED 39 
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27 


in structure processor 46 
DECLARE statements 29,35 
DEFINED scan 47 
error 69 
hash 33 
picture 34 

validity check 38 
PROCEDURE- ENTRY BEGIN 29 
STATIC 39,61 

in structure processor 46 
scan of external section 68 
SUBS TABLE 49 
symbol variables 62 
type 1 entry 68 
chamelon dummy argument 45 
chamelon temporaries 41-42 
character translation 21 
CHAR48 option 24 
check, syntax 26.1,161 
CHECK lists, formal parameters 38 
circular chains 
extended 34 
initialized 33 
cleanup phase 27 

CLOSE statements, parameter list 57 
closing routine 26 
CNVC macro 6 0 

COBOL chain, mapped in preprocessor 
phase 4 6 

COBOL option, in ENVIRONMENT string 41 
code byte 

for TASK option 41 
GOOB 37 
GOTO 37 

statement introduction 37 
text string 17 
code 

for prologues and epilogues 460-465 
library call 46 
compiler completion 23 
dictionary 26 

comments, removed from input text 29 
common data space 48 
commoning of subscripts 48-49 
communication between phases 17,21 
communication with control program 15 
communications region 
contents 17 
Control Code word 17 
dictionary block 17 
initialization 21 
of dictionary 17 
options 17 
tables 451-457 
use 21 
ZPRNAM 67 
compare action 44 
compare weight 44 
compilation 

as a job step 15 
bypassed 28 
termination 70 
compile-time processor 15 

communications region 479-482 
constants 30 
control interfaces 482 
identifiers 30 

internal formats of text 474-478 


logical phase 
operators 30 
output string 30 
SOURCE option 23 
compiler control 21-26.1 
compiler control modules 21,24-26.1 
compiler control phases, tables 75-86 
compiler control routines 15 
compiler functions, scan in pseudo-code 
phase 59 

compiler logic, guide to 71 
compiler organization and control 
diagram 20 

compiler read routine 28 
compiler 

as part of operating system 15 

completion code 23 

functions 32 

initialization 21 

invocation by calling program 21 

output data sets 15 

phases 15 

pseudo variables 32 
purpose 15 

storage requirements 15 
completion code 23 

concatenation, in 48 character set 27 
consistency of attributes 29 
consistency of options 29 
constant chain 60-61 
constants pool 60 
constants 
chain 38 

contextual use 31 
conversion to binary 37 
count 37 

dictionary entries 28 
in compile-time processor string 30 
marker 37 
contextual 

constants 31 
identifiers 31 
pictures 31 
control 

diagram 20 

of dictionary block 21 
of text block 21 
control cards 26.1,86 
control blocks 
DECLARE 41 
OPEN 41 

Control Code word 17,26 
control module 21,24 
control of workspace 15 
control program 15 
control routines 28 
compiler 15 
debugging 15 
diagnostic messages 23 
entry 21 

initialization 15 
input/output 15 
input/output 23 
program interruptions 15 
storage allocation 15 
storage dumping 15 
table Of 488-501 
ZUBW 27 
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ZURD 27 

control tables 86 

control variables in pseudo-code phase 
CONTROLLED chain 
scan 39 

in structure processor 46 


52 


Index 504.1 



CONTROLLED variables, RDV 57 
CONV macro 6 0 
CONV pseudo-code macro 59 
conversion 

absolute addresses 15 
constants to internal form 60 
input characters 28 
symbolic references 15 
of built-in functions 42 
of character codes 30 
of constants 37 
of precision data 34 
of replication factors 52 
to EBCDIC 28 
to internal code 28 
to triples 44 

48 to 60 character symbols 26.1 
CONVERT pseudo-code macro 60 
correction of syntactical errors 29 
correspondence defining 47 
count stack 37 
count, of constants 37 


Data Element Descriptor (DED) 37 
for symbol variables 62 
data flow diagram 16 
data sets 

compiler output 15 
data flow diagram 16 
INCLUDE 27 
input/ output 15 
input/output usage table 24 
interface with compiler phases 23 
opening 21 
SYSIN 15 
SYSLIN 15 
SYSPRINT 15 
SYSPUNCH 15 
SYSUTl 15 
SYSUT3 15 
TRACEOUT 26 
DD statement 15 
debugging 

control routines 15 
features 26 
DECLARE chain 29 
DECLARE control block 41 
DED (see Data Element Descriptor) 
default rules, in dictionary entries 34 
DEFINED chain check 46 
DEFINED chain, scan 47 
DEFINED data 39 

DEFINED items, in aggregates phase 47 
defined references 39 
defined slot 36,39 
defining 

dynamic 39 
static 39 
validity of 39 

detection of syntactical errors 29 
diagnostic message chain 30 
diagnostic messages 15 

allocation to phases 466-473 
parameters in dictionary chain 30 
diagnostics 

for invalid characters 28 
syntax errors 28 


dictionary 

accessing 31 
annotated dump 25 
areas 31 
BCD entries 26 
codes 26 

communications region 17 
constant chain 60 
constructing 31 
default rules 34 
diagnostic message chain 30 
diagnostic messages 23 
dump 2 6 

embryo entry 29 
extended 26 
hash table 31 
identifiers 31 
normal extended 21 
normal size 26 
organization 17 
resident table 384 
search 31 
dictionary block 

as communications region 17 
control 21 
release 28 
size 15 

space allocation 21 
dictionary entries 
attributes 28 
AUTOMATIC chain 38 
code bytes 387 
constants 28 
copy made 36 
data byte 38 
defined data 39 
definition of types 32 
diagram for internal entry point 33 
dimension table 412 
dope vector descriptor 47 
dummy reference 35 
entry points 32 
expanded 39 
for file conditions 38 
for file constants 41 
for ON conditions 37 
for STATIC DSAs 61 
format 17 
formats 

AUTOMATIC chain delimiter 409 
BCD entries 407 
built-in-functions 406-407 
CHECK list 408 
code bytes 397-400 
compiler labels 404 
constants 405-406 
data items 395-396 
DED 410 
DED2 410 


dope vector skeletons 409 

dope vectors for temporaries 410-411 

DVD 411 

ENTRY code byte 393-394 
entry points 389-393 
entry type 1 389-391 

emtry type 2 391 

entry type 3 391-392 

entry type 4 392-393 
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entry type 5 393 

error message 411-412 
EVENT data 406 

FED (Format Element Descriptor) 410 
files 405 

formal parameters 404 
GENERIC entry 393 
internal library functions 407 
label BCD entries 410 
label constants 404 
label variables 394-395 
ON condition 408 
ON statements 407-408 
optimization code byte 394 
options code byte 394 
parameter descriptions 407 
parameter lists 409 
pictures 408-409 
RDV 411 

second code byte 407 
SETS list 392 
STATIC DSA 411 
structure entries 396 
symbol table entries 409 
task identifiers 406 
variable information 400-401 
wprkspace requirements 409 
GENERIC 42 

INITIAL value list 413 
INITIAL values 412-413 
internal formats 387-413 
iterative DO-loops 28 
labels 30 
LIKE referemce 36 
optimization 34 
options code byte 34 
picture table 34 
pictures 38-39 
RDV and DVD 62 
record dope vector 47 
REVERT statements 38 
SIGNAL statements 38 
skeleton dope vector 61 
statement labels 29 
symbol table 62 
dictionary logical phase 31 
dimensions, inherited 38 
DISPLAY statements, parameter list 56 
DO group stack 52 
DO MAP 

chain 48 
table 48 

DO statements, count 29 
DO- loop control optimization 50 
dope vector descriptor, dictionary 
entry 47,62 

'dope vector required' bit 39 
dope vector, virtual origin slot 46 
DROP item in pseudo code 51 
DSA (see Dynamic Storage Area) 

D SLOTS 22 
DTSP 25 
DTSPC 25 
dummy arguments 
charnel ons 45 
when created 45 
dummy dictionary reference 35 
dummy reference, in second file 38 


dummy references, in text 37 

DUMP option, effect on SIZE option 25 

dump 

of dictionary 26 
on SYSPRINT 25 
DUMP 

option 25 
parameter 25 
dumping, inter-phase 25 
DVD (see dope vector descriptor) 62 
dynamic defining 39 
dynamic dump 25 
Dynamic Storage Area (DSA) 51 
optimization 64,464-465 
tasking information 63 


EMPTY built-in function 42 
END card 69 
END statements 
count 29 
inserted 29 

end-of-file indication 29 
end- of -program indication 29 
count 30 

end- of -program marker, in pseudo-code 
phase 54 

entry labels, in source text 29 
entry point, formal parameter 36 
entry points, dictionary entries 32 
entry type 1 68 

ENVIRONMENT option, for file constants 41 
ENVIRONMENT string, with COBOL option 41 
environmental options, use of 15 
EOB (end of block) 

EOB operator 44 

epilogue code, examples 460-465 

erroneous references, replaced in text 37 

error chains 69 

ERROR condition 29 

error dictionary entries 69 

Error Editor 30 

error editor logical phase 69 

error message text 70 

error messages 

classification 23 
order of severity 28 
phase directory 23 
text 2 8 

errors and diagnostic messages 29 
errors, detected in read-in phase 31 
ESD (see External Symbol Dictionary) 
EXCLUSIVE second level marker 41 
EXEC STATEMENT 15 

explicitly generated statements, in 
pretranslator phase 40 
expression, definition 42 
expressions 

array bounds 32 

initial value iteration factors 32 
string lengths 32 
structure 43 

extended dictionary 21,26 
external library routines 439 
External Symbol Dictionary 
ESD cards 67 
in data flow diagram 16 
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67 


factored attribute table 34 
factored attributes 34 
file conditions, dictionary entries 38 
final assembly logical phase 67 
First Level Directory, format 385 
flow trace, not carried out by compiler 
FLOW/TRACE facilities 26.1 
flow/trace markers 86,86.1 
flowcharts (see also Phases and Modules) 
organization 71 
overall compiler logic 72-73 
resident control phase 74 
formal parameter list 39 
formal parameters, in CHECK or NOCHECK 
lists 38 

formats of dictionary entries 387-413 

freed registers 67 

FREEDS A 55 

function calls 42 

function references 41 

functions 32 


generic built-in functions 33 
GENERIC entry label 42 
generic phase 43 
GET statements, library call 58 
GLOBAL region boundary 49 


halfword binary items 65 

hash chain, used to scan dictionary 37 

hash chains 33 


hash table 

33 

address 

31 

deleted 

32 

in dictionary 

housekeeping 

38 

identifiers 



contextual use 31 
implicit definition 31 
in compile-time processor output 
string 30 

in dictionary logical phase 31 
in multiple declarations 35 
when rejected 35 
IDV (see Initial Dope Vector) 

IEMAA 21 

IEMAF control section 458 

IEMKTAB macro 485 

IEMKTCA macro 483-484 

IF statements, count 29 

IHELSP 56 

IHEMAIN 69 

IHEQERR 68 

IHEQTIC 68 

IHESADA 68 

IHESADB 68 

IHESTGA 54 

IHESTGB 54 

in-line pseudo code 52-53 
INCLUDE data set 27 
inherited dimensions 38 

INITIAL attribute, second file entries 36 
Initial Dope Vector, scan for 
statements 51 


initial labels 

in pseudo-assignment statements 30 
subscripted label variables 30 
initialization 

of compiler 21 
of control routines 15 
input, original 27 
input text 17 

end-of-file indication 29 
input/output 

control routines 15 
control routines 23 
data set usage table 24 
data sets 15 

library call for RECORD I/O 56 
insertion file 66-67 

insignificant blanks, removed fron input 
text 29 

inter-phase dumping 25 
interface 

with data sets 23 
with operating system 15 
intermediate file 24 
internal code 29 

in text string 17 
internal entry point, diagram 33 
internal formats of dictionary 
entries 387-413 

Internal Formats of Text 414-448 
internal library routines 438-439 
interruptions, control routines 15 
invalid attributes, check for 34 
invalid characters 
diagnostics 28 
replaced by blanks 27 
used as markers 28 
invalid pictures 38 
invariance of subscripts 48-49 
IRREDUCIBLE 36 
iSUB references 40 
iSUBS 43 

ITDO region boundary 49 

iteration factors, initial value 32 

iterative DO-loops, dictionary entries 28 


Job Control Language 15 
JOB statement 15 
job step 15 
job termination 23 


K phases, table handling routines 483-487 
KEYID routine 384 
KEYWD routine 384 
Keyword tables 

construction 384 
in read-in logical phase 30 


label table 29 

labels, inserted in dictionary 30 
level stack 37 
library call sequences 

for not in-line CHAR and BIT string 59 
for stroage triples 59 
library call 

data transmission 58 
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GET and PUT statements 58 
initialization 58 
RECORD-oriented I/O 56 
termination 58 

library calling sequences 438 
library conversion routines 68 
library error package 66 
library routines 
external 439 
FREEDS A 55 
IHELSP 56 
IHEQERR 68 
IHEQTIC 68 
IHESADA 68 
IHESADB 68 
IHESTGA 54 
IHESTGB 54 
internal 438-439 
library work store <LWS) 63 
Library, call code 46 
LIKE attribute 36 
LIKE chain 36 
line numbering 27 
Link Library 15 
Linkage Editor 15 
Linkage Loader 15 
lists 

SUBS/REGION 48 
USE 48 

load-ahead technique 35 

loader text, TXT cards 68 

location counter, for assembled code 68 

logical phases, table 18-19 

LWS (see library work store) 63 


machine instructions, in text string 17 
MACRO option 24,27 
macro-code interpreter 28 
main storage 

release of 26 
requirements 22 
Map, Phase-in-Storage 383 
marker byte function references 41 
markers (see also second level markers) 41 
argument 52 
constant 37 
end-of -program 54 
function call 42 
multiple assignment 54 
P format 37 
procedure calls 42 
pseudo-variable 54 
'unsafe' 48 

use of invalid characters 28 
wanted or not wanted 44 
match chain, in SUBS TABLE 49 
message directory block 28 
messages (see also diagnostic messages, 
error messages) 

classification 23 
control routines 23 
diagnostic 15 
dictionary chain 23 
misaligned argument 65 
misaligned operands 65 
mixed overlay defining 47 
modules (see also Phases and Modules) 


compiler control 24-26.1 
IEMAA 21 

MTF (multiplier function) 

MTF statement 39 
multiple assignment markers 54 
MULTIPLE ASSIGNMENT triples 59 
multiple declarations 35 


NAME card 69 

nested procedures, unnested at object 
time 68 

nesting, patch code 48 

NOCHECK lists, formal parameters 38 

'not sold' temporaries 42 

null arguments, in parameter lists 57-58 

NULL built-in function 42 

NULLO built-in function 42 


object program 17 
OBJNM parameter 69 
OFFSET slots 403-404 
OFFSET 2 slot, diagram 402 
offset, calculation in structure 
processor 46 

ON conditions, dictionary entries 37 
ON statements, count 29 
OPEN control block 41 
OPEN statements, parameter list 57 
opening of data sets 21 

operators, in compile-time processor output 
string 30 

optimization byte 34 
optimization logical phase 47 
storage blocks 22 
optimization 
of DSA 64 
subscripts 48-49 
option list, printing 21 
options code byte 34 
options list, initial scan 21 
options 
ATR 39 
BY NAME 40 

check for legal combinations 58 

consistency 29 

Control Code word 17 

control section 25 

environmental 15 

in communications region 17 

in data flow diagram 16 

instructions to compiler 15 

interpretation of 15 

MACRO 27 

scanned 34 

source program 15 

status byte 15 

stored in dictionary 17 

TRACE/PATCH 26 

XREF 3 9 

ORDER, default setting 47 
organization, diagram 20 
original input 27 
output string 

from compile-time processor 30 
in read-in phase 29 
output, of read-in phase 29 


508 



overlay defining 47 
mixed 47 
scalars 47 

undimensioned structures 47 


padding, calculation in structure 
processor 46 

parameter description, in entry 
declaration 42 
parameter list 

DISPLAY statements 56 
for library call initialization 58 
for OPEN and CLOSE statements 57 
library calls 56 
null arguments 57 
WAIT statements 56 
parameter matching 32 
parameter registers 51 
parameters, of diagnostic messages 30 
PARTIAL SAFE/UNSAFE boundaries 49 
patch code 

in nest of loops 48 
in optimization phase 48 
PATCH/TRACE option 26 
patch file 47 
PATCH facilities 26.1 
PEXP (see pointer expression) 

PEXP statement 36 
deleted 39 
phase deleting 23 
phase directory 384 
construction 23 
error messages 23 
format 386 
status byte 15 
phase loading 23 
phase marking 23 
Phase-in-Storage Map 383 


phase. 

wanted/not wanted 23,35,44 

Phases 

and Modules - Guide 379-382 

Phases 

and Modules - Descriptions, 

Flowcharts, and subroutine Tables 

AA 

21,74,75-77 

AB 

21,74,78-79 

AC 

24,74,79 

AD 

25,74,79 

AE 

25,74,80 

AF 

25,74,80 

AG 

25,74,80 

AH 

26,74 

AI 

26,74 

AJ 

26,74 

AK 

26,74,80 

AL 

26,74,81-85 

AM 

26,74,86 

AN 

26,81-85 

AS 

27,88,94-95 

AT 

26,74.1,86,86.1 

AV 

27,89,96 

BC 

27-28,90,97-98 

BE 

27 

BF 

27 

BG 

28,91,100-101 

BI 

28 

BJ 

28 

BM 

28,92,102 

BN 

28 


BO 

BP 

BW 

BX 
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CC 
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EY 
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GK 
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HF 

HK 

HP 

IA 

IG 

IK 

IL 

IM 

IT 

IX 

JD 

JI 

JK 

JP 

JZ 

KA 

KB 
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28 

through BV 28 
28, 93 

26,105,111 

30. 112 

30.113 
30, 113 
30 

30-31,106,114 

30 

30,107,115 

30 

30 

30-31,108,116 

30 

30 

30-31,109,117 

30 

30-31,110,118 

30 

33,135 

33 

33-34,120,135 

34 

34,121,137-138 

34 

35 

35,122,140-141 

35 

35- 36,123,143-144 

36 

36.124.145 

36.125.146 
26. 1,161 

36- 37,126,147-148 

37. 127.149- 150 

37.128.150- 151 
37,129,152 

37- 38,130,153 
38,131,154-155 

38- 39,132,156-157 
39,133,158-159 

39- 40,134,160-161 
41,163,171 
41-42,164,172-173 

41 

41,165,174 

42 175 

42*166,176-177 

43,167,179-180 

43,168,181-182 

43.169.183 

43.170.184 

44.186.194 

45.187.195 

45.188.196 

45.189.196 
45,190,196-197 
45,191,198-199 

45- 46,192,199 
46,193,200 
46,202,205 

46- 47,203,206-207 

47. 204.208 

26. 1.74.208 

48.210.220 
48 

48.212.221 
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KE 48 , 213,221-222 
KG 48-49, 214,222 
KJ 49,215,223 
KN 49,216,224 
KO 49-50,217,225-231 
KP 49 
KQ 49 

KT 50,218,232-233 
KU 50,219,234-236 
KV 50 

LB 51,238,268 
LD 52,239,269 
LG 52,240,270-271 
LR 52 

LS 52-53,241,272-273 
LV 53,242,274 
LW 53 

LX 53,243,275-276 
LY 53 

MA 53-54,244,277-278 
MB 54,245,279-280 
MD 54,246,281 
ME 54,247,282 
MG 54,248,284 
MI 54,249,287 
MK 55,250,288 
ML 55,251,289 
MM 55,252,289-290 
MP 55,253,291 
MS 55,254,292-293 
NA 55-56,255,294-295 
NG 56,256,297 
NJ 56-57,257,298-302 
NM 57-58,258,304 
NT 58,259,305 
NU 58,260,306 
OB 59,261,307-309 
OD 59,262,310 
OE 59-60,263,311 
OG 60,264,312-313 
OL 60 

OM 60,265,314 
OP 60,266,315 
OS 60,267,316 
PA 61,319,329 
PD 61,320,330 
PH 61-62,321,331-332 
PL 62,322,333 
PO 62 

PP 62-63,323,334-335 
PT 63,324,336-337 
QF 63-64,325,338-339 
QJ 64,326,340-341 
QU 65,327,342-343 
QX 65,328,344 
RA 66,346,349-350 
RB 66 
RC 66 

RD 66,347,351-352 
RF 67,348,353 
RG 67 
RH 67 

TF 67,356,365 
TJ 67,357,366 
TO 67-68,358,367 
TQ 67-68 

TT 68,359,368-369 
UA 68-69,360,370-371 


UD 69,361,372 
UE 69,362,373-374 
UF 69,363,375-376 
UH 69 
UI 69 

XA 69,364,378 
XB 69 
XC 69 
XF 69 

XG through YY 69-70 
phases 

branch after execution 17 
communi cation between 17 
control between 17 
logical 17 

Aggregates 18,46-47,201 
Compile-time Processor 18,27-28,87 
Dictionary 18,31-40,119 
Error Editor 19,69,364 
Final Assembly 19,67-69,355 
Optimization 18,47-50,209 
Pretranslator 18,40-43,162 
Pseudo-code 18,50-60,237 
Read-In 18,28-31,104 
Register Allocation 19,66-67,345 
Storage Allocation 19,60-65,318 
Translator 18,43-46,185 
organization 17 
physical 17 
table 18-19 

physical registers, use 51 
picture 

chain 34,38 
contextual use 31 
dictionary entry 34,39 
marker 37 
table 34 

pointer expression (PEXP) 39 
POINTER, in pointer expression 39 
prefix form 44 
preprocessor 46 

in aggregates phase 46 
48-character set 26.1 
pretranslator logical phase, control passed 
to 40 

procedure calls 42 
PROCEDURE statements, count 29 
PROCEDURE- ENTRY-BEGIN chain 29 
processing program 15 
program check handling 23 
prologue 61 

contruction 63 
prologue code 64 
examples 460-465 
prologue time 38 
pseudo- code logical phase 50 
pseudo-code 

definition 50 
design 50,429-432 
DROP item 51 

generation using BXH and BXLE 
instructions 47 
in-line 52-53 
skeletions 58 
temporary descriptions 438 
pseudo-variable markers 54 
pseudo-variables 32 

scan in pseudo-code phase 59 
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correction 29 
detection 29 
in read-in phase 29 
SYSIN 15 

opening 21 
SYSLIN 1 5 
SYSPRINT 1 5 
dump 2 5 
opening 21 
SYSPUNCri 1 5 
opening 2 1 

system generation, tables 458-459 
SYSUT1 15 
SYSUT3 15 

closed for output 25 
control 24 
open for input 25 
opening 2 1 
ZURD routine 25 


table control area 483 
table control block area 48 
table of logical phases 18-19 

tables and routine directories, introduction 71 
TASK option, code bytes 41 
tasking information in DSA 63 
TCA (see table control area) 

TDPSCIE 25 

temporary description stack 436-437 
temporary descriptors 51 

Temporary Result Descriptor Triples (TMPD) 51,436 

temporary workspace 5 1 

termination error messages 23 

termination of compilation 70 

termination, of statements 30 

terms used during compilation 439-448 

testing, for consistency of attributes 32 

text additions 

BUY statements 40 
I/O statements 40 
SELL statements 40 
statements within statements 40 
temporary storage 40 
unbrella symbol 40 
text blocks 

chaining 22 
control 21 
markers 28 
release 28 
size 15 

space allocation 21 
spilled 17 
symbolic name 17 
text chain 39-40 
text code bytes 17 

first level table 415-416 
is pseudo-code 429 

on entry to translator phases 424-425 
second level table 417-418 
text formats 

absolute code 433-434 
after read-in phase 418-423 
in pseudo-code 429 
internal 414 
triples 426-428 
text scratch storage 39-40 
text string processing 17 


text, annotated dump 25 
text, of error messages 28 
Third Level Tables 385 

TMPD (see Temporary Result Descriptor Triples) 
transfer vector 27 

to control routines 21 
transformation subscripts 48-49 
translation table 29 
translator logical phase 
generic phase 43 
stacker phase 43 
triple names (see Appendix D.11) 
triples 

ASSIGNMENT 59 
format 44 

MULTIPLE ASSIGNMENT 59 
PTCH 47 

SPECIAL ASSIGNMENT 59 
when generated 44 
TSLOTS 22 

TXT (see loader text) 

type 1 entry 68 

types of dictionary entries 32 


unary profixea triples 46 

undefines formal parameter 36 

undimensioned structure overlay defining 47 

'unsafe' variables 48 

USE list 48 

USSL declaration 50 


validity check, PICTURE chain 38 
value scan 28 
Variable Data Area 

in AUTOMATIC chain 63 
in pseudo-code phase 55 
variable storage accumlator 64 
variables 

aliasing 47 

RDV for CONTROLLED or BASED 57 
symbol table 62 
VDA (see Variable Data Area) 
virtual origin slot of dope vector 46 


WAIT statements, parameter list 56 

warning messages 23 

weights, compare 44 

weights, stack 44 

work data sets (see data sets) 

XREF option 39 

ZCOMM 479 
ZPRNAM 67 
ZUBW 27 
ZURD 27 

ZURD routine 25 


48-character set 15 
concatenation 27 
48-character set preprocessor 26 
input 27 
output 27 

48-character syntax 26 
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STATIC DSA 61 
status byte 15 
status indications 23,386 
status slot 

dictioary block 22 
text block 22 
storage 

attribute collection area 35 
auxiliary 17 
program too large 21 
spilled 17 
spilling 15 

storage allocation logical phase 60 
storage allocation table 450 
storage allocation, control routines 15 
storage blocks 

availability 22 
span of complete statement 30 
storage dumping, control routines 15 
storage requirements 15,449-450 
storage size, as an argument 15 
string lengths 32 

structure assignment statements 43 
structure expressions 43 
structure level numbers 34 
structure processor, in aggregates 
phase 46 

SUBS/REGION list 48 
SUBS table 49 
subscript optimization 
commoning 48-49 
invariance 48-49 
transformation 48-49 
substitutions, in source text 29 
symbol table dictionary entry 62 
symbol variables, DED 
symbolic accumulator register 46 
symbolic name, text blocks 17 
symbolic references, conversion 15 
symbolic register counter 51 
symbolic registers 67 
syntactical errors 
syntax check 26.1,1 61 
correction 29 
detection 29 
in read-in phase 29 
SYSIN 15 

opening 21 
SYSLIN 15 
SYSPRINT 15 
dump 25 
opening 21 
SYSPUNCH 15 
opening 21 

system generation, tables 458-459 
SYSUT1 1 5 
SYSUT3 15 

closed for output 25 
control 24 
open for input 25 
opening 21 
ZURD routine 25 


table control area 483 
table control block area 48 
table of logical phases 18-19 
tables, control 86 


tables and routine directories, 
introduction 71 
TASK option, code bytes 41 
tasking information in DSA 63 
TCA (see table control area) 

TDPSCIE 25 

temporary description stack 436-437 
temporary descriptors 51 
Temporary Result Descriptor Triples 
(TMPD) 51,436 
temporary workspace 51 
termination error messages 23 
termination of compilation 70 
termination, of statements 30 
terms used during compilation 439-448 
testing, for consistency of attributes 32 
text additions 

BUY statements 40 
I/O statements 40 
SELL statements 40 
statements within statements 40 
temporary storage 40 
umbrella symbol 40 
text blocks 
chaining 22 
control 21 
markers 28 
release 28 
size 15 

space allocation 21 
spilled 17 
symbolic name 17 
text chain 39-40 
text code bytes 17 

first level table 415-416 
is pseudo-code 429 

on entry to translator phases 424-425 
second level table 417-418 
text formats 

absolute code 433-434 
after read-in phase 418-423 
in pseudo-code 429 
internal 414 
triples 426-428 
text scratch storage 39-40 
text string processing 17 
text, annotated dump 25 
text, of error messages 28 
Third Level Tables 385 
TMPD (see Temporary Result Descriptor 
Triples) 

TRACEOUT data set 26 
TRACE/FLOW facilities 26.1 
trace/flow markers 86,86.1 
TRACE/PATCH option 26 
trace routine 86.1 
transfer vector 27 

to control routines 21 
transformation subscripts 48-49 
TRANSLATE built-in function 52,277 
translation table 29 
translator logical phase 
generic phase 43 
stacker phase 43 
triple names (see Appendix D.ll) 
triples 

ASSIGNMENT 59 
format 44 
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MULTIPLE ASSIGNMENT 59 
PTCH 47 

SPECIAL ASSIGNMENT 59 
when generated 44 
TSLOTS 22 

TXT (see loader text) 

type 1 entry 68 

types of dictionary entries 32 


unary prefixed triples 46 
undefined formal parameter 36 
undimensioned structure overlay 
defining 47 
•unsafe* variables 48 
USE list 48 
USSL declaration 50 


validity check, PICTURE chain 38 
value scan 28 
Variable Data Area 

in AUTOMATIC chain 63 
in pseudo-code phase 55 
variable storage accumlator 64 
variables 

aliasing 47 

RDV for CONTROLLED or BASED 57 
symbol table 62 
VDA (see Variable Data Area) 


VERIFY built-in function 53,277 
VERIFY instructions 26.1 
virtual origin slot of dope vector 


WAIT statements, parameter list 56 

warning messages 23 

weights, compare 44 

weights, stack 44 

work data sets (see data sets) 


XREF option 39 


ZCOMM 479 
ZPRNAM 67 
ZSTAT 26.1 
ZUBW 27 
ZURD 27 

ZURD routine 25 


48-character set 15 
concatenation 27 

48-character set preprocessor 26.1 
input 27 
output 27 

48-character syntax 26.1 


46 


Index 513 



GY28-6800-5 



International Business Machines Corporation 
Data Processing Division 

1133 Westchester Avenue, Whits Plains, New York 10604 
[U.S.A. only] 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

[International] 


IBM System/360 Printed in U.S.A. GY28-6800-5 



